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About 
This Book 


The Magnetic Tape User's Guide is for both new and experienced users of 
magnetic tapes. It contains information on magnetic tape and tape 
device characteristics, and PRIMDS magnetic tape commands and 
subsystems. For more detailed magnetic tape information for the Syston 
Administrator and operator, refer to the System Administrator's Guide. 


HOW TO USE THIS BOOK 

Part I (Chapters 1 to 3) introduce magnetic tape characteristics and 
related concepts. New magnetic tape users should read these chapters 
first as introductory material before moving on to later chapters. 
Those who have used tapes before might use Part I for reference 
purposes. 

Part II (Chapters 4 to 6) covers PRIMDS magnetic tape commands. 
Chapter 4 describes commands for user control of tape drives. Chapter 
5 describes commands for operator control of tape drives. Chapter 6 
covers commands that initialize magnetic tapes. 

Part III (Chapters 7 to 9) covers PRIMDS magnetic tape subsystems: 
MAGSAV, MflGRST, PHYSAV, and PHYRST. In addition. Chapter 7 is entirely 
devoted to the new MAGNET subsystem. 


ix 






The Appendixes contain additional information on MAGNET edit tokens, 
translation tables, command line options, and batch jobs. Also 
included are ASCII, EBCDIC, and BCD character set tables, and notes on 
pre-Rev 18.3 MAGNET. 
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PRIME DOCUMENTATION CONVENTIONS 

The following conventions are used in command formats, statement 
formats, and in examples throughout this document. Command and 
statement formats show the syntax of commands, program language 
statements, and callable routines. Examples illustrate the uses of 
these commands, statements, and routines in typical applications. 
Terminal input may be entered in either uppercase or lowercase. 


Convention Explanation Example 

UPPERCASE In command formats, words in SLEST 

uppercase indicate the actual 
names of commands, statements, 
and keywords. They can be 
entered in either uppercase 
or lowercase. 


abbreviations If a command or statement 
has an abbreviation, it is 
indicated by underlining. 

lowercase In command formats, words 

in lowercase indicate items 
for which the user must 
substitute a suitable value. 


KJGCUT 


LOGIN user-id 


underlining 

in 

examples 


In examples, user input is OK, stat units 
underlined but system prompts USR=SUSANA ENA 
and output are not. 

NO FILE UNITS OPEN 
OK, 


Brackets 
[ ] 


Brackets enclose a list of SPOOL [”-LIST 
one or more optional items. -CANCEL 

Choose none, one, or more of 
these items (0 - n). 


x 











Braces 

{ 1 


Ellipsis 


Parentheses 

( ) 


Hyphen 


(CR) 


Braces enclose a vertical CLOSE I filename 

list of items. Choose one {ALL 

and only one of these items. 


An ellipsis indicates that item-x[,iten-y]... 

the preceding item may be 
repeated. 

In command or statement DIM array (row,col) 

formats, parentheses must be 
entered exactly as shown. 


Wherever a hyphen appears in SPOOL -LIST 
a command line option, it is 
a required part of that 
option. 


The (CR) symbol indicates a 
single carriage return which 
is generated by hitting the 
RETURN key on most terminals. 
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-USER 7-3, B-l, C-5 

Commands: 
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LINES, MAGNET option 7-59 
LIST: 

abbreviation C-6 
subcommand 7-29 
subcommand line format 7-29 

LOAD: 

abbreviation C-6 
MAGNET subcommand 7-58 
subcommand line format 7-58 


Logical device number: 
assigning tape drives by 
4-4 to 4-6 
defined 4-3 
in MAGRST dialog 8-8 

in MAGSAV dialog 8-4 

in PHYRST dialog 9-16 
in PHYSAV dialog 9-4 
unassigning tape drives by 
4-8 

Logical record 1-4, 2-5, 2-6 

Logical record size C-2 

Logical tape format 1-6 

Logical tape format, diagrammed 
1-7 

LONG, MAGSAV option 8-3 
LOWEND, PHYSAV option 9-3 
LRECL: 

MAGNET option 7-12, 7-13 
MAGNET option, diagrammed 
7-14, 7-15 

MAGNET subcommand options: 
ACCESS 7-49 
AMOUNT 7-39, 7-40 
AT 7-28 

BFACTOR 7-12, 7-13 

BFACTOR, diagrammed 
7-14, 7-15 
BUFFERS 7-28 
BYPASS 7-26 
CHARACTERS 7-52 
CONTROL 7-53 
COPIES 7-28 
CREATE 7-49, 7-50 
DEFER 7-53 
DENSITY 7-13 
DISK 7-12 
EXCHANGE 7-52, 7-53 
EXPIRE 7-49, 7-50 
EXTERNAL 7-43 to 7-45 
FILEID 7-24 
FILENO 7-24 
FORM 7-29 
FORMAT 7-16, 7-17 
FORMAT, diagrammed 7-18 
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GENERATION 7-50, 7-51 
ITEMS 7-29, 7-30 
LABELS 7-17, 7-19 
LEVEL 7-19 
LEVEL, diagrammed 
7-20 to 7-23 
LIKE 7-45 
LINENOS 7-56 
LINES 7-59 
LRECL 7-12, 7-13 
LRECL, diagrammed 7-14, 7-15 
MAXIO 7-53 
MODE 7-41, 7-42 
NEXTCHAIN 7-47 to 7-49 
OFFSET 7-51 
OWNER 7-24, 7-25 
PAD 7-56 
PARITY 7-17 
POSTACTION 7-46, 7-47 
PREACTION 7-46, 7-47 
PREVCHAIN 7-47 to 7-49 
PRINT 7-40, 7-41 
PROTECT 7-17 
REGORDNO 7-25, 7-26 
SEQUENCE 7-51 
SPOOL 7-12 
table of 7-7 to 7-11 
TAPE 7-12 
TRACKS 7-13 
TYPE 7-58, 7-59 
VERSION 7-50, 7-51 
VISUAL 7-26 
VCLSER 7-25 

MAGNET: 

additional features and notes 
C-l to C-6 

advanced 7-42 to 7-62 
basic steps 7-2 
facilities provided by 
7-1, 7-2 
invoking 7-3 
messages 7-64 to 7-97 
Pre-Rev 18.3 features 
C-l to C-6 

sample session 7-62 to 7-64 
subcommand line format 7-3 
subcommands 7-3 
types of messages 7-64 
using 7-2 


Magnetic spots 1-2 

Magnetic tape standards 
2-6 to 2-13 

Magnetic tapes: 

physical characteristics of 

1 - 1 , 1-2 

MAGRST command options: 

7TRK 8-7, 8-8 
TTY 8-7 

MAGRST: 

command line format 8-7 
dialog 8-8 to 8-11 
messages 8-13 to 8-22 
password protection handled by 
8-11 to 8-12 

quotas handled by 8-13 
sample session 8-11 
subsystan 8-1, 8-7 to 8-22 

MAGSAV command options: 

7TRK 8-3 

INC 8-4 

LONG 8-3 

NOA 8-4 

NO_ACL 8-4 

P300 8-3 

SAVEJJFD 8-2, 8-4 

SUED 8-2, 8-4 

TTY 8-4 

UPDT 8-3 

VAR 8-3 

MAGSAV: 

ACLs handled by 8-6 to 8-7 
archiving with 8-1 to 8-2 
backups with 8-1 to 8-2 
basic steps 8-3 
command line format 8-3 
dialog 8-4 
messages 8-13 to 8-22 
quotas handled by 8-7 
sample session 8-6 
subsystem 8-1 to 8-7, 

8-13 to 8-22 

Marker: 

beginning-of-tape 1-8 
end-of-tape 1-8 
file 1-6 
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tape 1-6 

MAXIO, MAGNET option 7-53 
Messages: 


ASSIGN 

4-6, 4-7 

DISMOUNT 7-3, B-l, 1 

LABEL 

6-3 to 6-6 

MAGNET 

7-64 to 7-97 

MAGRST 

8-13 to 8-22 

MAGSAV 

8-13 to 8-22 

MOUNT 

7-3, B-l, B-2 

PHYRST 

9-19 to 9-25 

PHYSAV 

9-6 to 9-15 

REPLY 

5-5 

SETMOD 

5-2, 5-3 

UNASSIGN 4-9 


MODE, MAGNET option 7-41, 7-42 
MODIFY: 

abbreviation C-6 
MAGNET subcommand 
7-32 to 7-34 

subcommand line format 7-32 

MOUNT messages 7-3, B-l, B-2, 
C-6 

MOUNT REPLY mechanism C-5 
MOUNT, ASSIGN option 4-4, 4-6 
Mounting tapes 4-6 
MOVE: 

abbreviation of C-6 
MAGNET subcommand 7-38, 7-39 
subcommand line format 7-38 

MTpdn 4-2 

MTX 4-2 

Multiple files, multiple reels 
3-15, 3-20 

Multiple files, single reel 
3-14, 3-18 

Multiple reels, multiple files 
3-15, 3-20 


Multiple reels, single file 
3-13, 3-19 

NEXTCHAIN, MAGNET Option 
7-47 to 7-49 

Nine-track tape: 
defined 1-2 
diagrammed 1-3 
parity of 1-10 

No assignment mode 5-1, 5-2 

NDA, MAGSAV option 8-4 

NOASSIGN, SETMOD option 5-2 

NOBADS, PHYRST option 9-15 

NOISY, MAGNET subcommand 7-61 

Non-return to zero inverted 1-8 

N0_ACL, MAGSAV options 8-4 

NRZI 1-8 

Object-name 7-6, 7-29, 7-39, 
7-41 

Off-line 4-8 

OFFSET, MAGNET Option 7-51 

Open status 7-29, 7-30 

Operator mode 5-1, 5-2 

OPERATOR, MAGNET Option 
7-3, B-l, B-2 

OPERATOR, SETMOD option 5-2 

OPR ( See OPERATOR, MAGNET 
option) 

OWNER, LABEL option 6-1, 6-2 
OWNER, MAGNET option 7-24, 7-25 
P300, MAGSAV option 8-3 
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Packing codes A-4 

Packing/unpacking, binary 1-11 

Packing/unpacking, binary 
(diagrammed) 1-12 

PAD, MAGNET option 7-56 

Parity bit 1-10 

Parity track 1-10 

PARITY, MAGNET option 7-17 

Partition 9-1 to 9-2 

Password protection: 
handled by MAGRST 
8-11 to 8-12 

pdn 4-2 

PE 1-8 

Phase-encoded 1-8 

PHYRST command options: 

NOBADS 9-15 

TTY 9-15 
UNMOD 9-15 

PHYRST: 

bit settings in messages 9-8 
command line format 9-14 
dialog 9-15 to 9-16 
messages 9-19 to 9-25 
reentering 9-18 
sample session 9-18 
subsystem 9-1, 9-15 to 9-25 

PHYSAV command options: 

LOWEND 9-3 
TTY 9-3 

PHYSAV: 

bit settings in messages 9-8 
command line format 9-2 
command options: UNMDD 9-3 
dialog 9-4 to 9-5 
messages 9-6 to 9-15 
reentering 9-5 
sample session 9-6 


subsystem 9-1 to 9-15 

Physical block 2-6 

Physical device number: 
assigning tape drives by 4-4, 
5-2, 5-4 
defined 4-2 
in MAGRST dialog 8-8 

in MAGSAV dialog 8-4 

in PHYRST dialog 9-16 

in PHYSAV dialog 9-4 

unassigning tape drives by 
4-8 


Physical record 1-4, 2-6 
POSITION subcommand C-l, C-2 
POSITION: 

abbreviations C-6 
MAGNET subcommand 7-41, 7-42 
pre-Rev 18.3 C-l, C-2 
subcommand line format 7-41 

Positioning, absolute 7-41, 
C-l, C-2 

Positioning, relative 7-41, 
C-l, C-2 

POSTACTION, MAGNET option 
7-46, 7-47 

Postamble 1-4, 1-8 

Pre-Rev 18.3 MAGNET C-l to C-6 

PREACTIDN, MAGNET option 
7-46, 7-47 

Preamble 1-4, 1-8 

PREVCHAIN, MAGNET option 
7-47 to 7-49 

Prime ASCII 1-10, A-l to A-3, 
A-5, C-2, C-5 

Prime ASCII table A-9, A-10 
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Prime ASCII to BCD translation 
table A-17, A-18 

Prime ASCII to EBCDIC 
translation table 
A-19 to A-21 

Prime ASCII to industry-standard 
ASCII translation table 
A-28 to A-30 

Prime binary tapes 2-7 

Prime variable-length format 
2-6 

PRINT, MAGNET option 7-40, 7-41 
PROTECT, MAGNET option 7-17 
QUIT: 

MAGNET subcommand 7-42 
pre-Rev 18.3 C-4 

subcommand line format 7-42 

Quotas: 

handled by MAGRST 8-13 
handled by MAGSAV 8-7 

RAT ( See Record availability 
table) 

RCW 2-2 

Read/write heads 1-8 
READ: 

abbreviation C-6 
MAGNET subcommand 7-37 
pre-Rev 18.3 C-2, C-3 

subcommand line format 7-37 

Record availability table (RAT) 
9-3 

Record control word 2-2 

REOORDNO, MAGNET option 
7-25, 7-26 

D a/ VNY* /Vi • 

fixed-length 1-4, 2-1, 2-2 
fixed-length, diagrammed 1-5 


logical 1-4, 2-5, 2-6 
MAGNET uncompressed 7-16 
physical 1-4 

spanned variable-length 2-5, 

2-6, 2-8 

variable-length 2-1 to 2-6, 

2-8 

Reel, tape (diagram of external 
features) 7-27 

Reel: 

physical characteristics of 
1-2 

supply 1-8 
take-up 1-8 

Relative positioning 7-41, 

C-l, C-2 

REN 9-18 

RENAME: 

abbreviation C-6 
MAGNET subcommand 7-32 
subcommand line format 7-32 

REPEAT, REPLY option 5-4 

Repetition factor * A-5 

REPLY command options: 

ABORT 5-4 
ALL 5-4 
GO 5-4 
REPEAT 5-4 
RESEND 5-4 
TAPE 5-4 

REPLY: 

command 5-1 to 5-5, B-l 
command line format 5-4 
command message 5-5 

RESEND, REPLY option 5-4 

RINGOFF 4-3 

RINGCN 4-3 

SAVE: 

MAGNET subcommand 7-57, 7-58 
subcommand line format 7-57 
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SAVE_UFD, MAGSAV option 8-2, 

8-4 

SCC ( See Segment control codes) 

SCW ( See Segment control word) 

Segment 2-5, 2-6 

Segment control codes: 

ANSI 2-6, 2-13 
IBM 2-5, 2-10 

Segment control word: 

ANSI 2-5, 2-6, 2-12 
IBM 2-5, 2-9 

Segment descriptor 2-5, 2-6 

SEQUENCE, MAGNET option 7-51 

SETMOD command modes: 
no assignment 5-1, 5-2 
operator 5-1, 5-2 
user (default) 5-1, 5-2 

SETMOD command options: 

NOASSIGN 5-2 
OPERATOR 5-2 
USER 5-2, 5-3 

SETMOD: 

command 5-1 to 5-3 
command line format 5-2 
messages 5-2, 5-3 


Settings, tape density 4-3 


Seven-track tape: 
defined 1-2 
diagrammed 1-3 
parity of 1-10 


Severity 0 MAGNET message 

7-64 

Severity 1 MAGNET message 

7-64 

Severity 2 MAGNET message 

7-64 

Severity 3 MAGNET message 

7-64 


SILENT: 

MAGNET option 7-3, B-l 
MAGNET subcommand 7-61 

Single file, multiple reels 
3-13, 3-19 

Single reel, multiple files 
3-14, 3-18 

Single reel, single file 3-12, 
3-17 


Source-object-name 7-39 

Spanned records, variable-length 
2-5, 2-8 

Specific ACLs, in MAGSAV 8-6 

Speed, tape drive 1-8 

SPOOL, MAGNET option 7-12 

Standards, magnetic tape 
2-6 to 2-13 

STATUS DEVICE: 
command 4-1, 5-1 
command line format 4-1 

STATUS DISKS, command 9-2 

Subcommand line format: 

/* 7-42 

COPY 7-39 
DECLARE 7-6 
DELETE 7-34 
DISPLAY 7-30 
LIST 7-29 
LOAD 7-58 
MAGNET 7-3 
MODIFY 7-32 
MOVE 7-38 
POSITION 7-41 
QUIT 7-42 
READ 7-37 
RENAME 7-32 
SAVE 7-57 
TRANSLATE 7-34 
WRITE 7-37 
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Subcommand options: 

MAGNET 7-12 to 7-59 
table of MAGNET 7-7 to 7-11 

Subcommands, advanced MAGNET: 
LOAD 7-58 
SAVE 7-57, 7-58 

Subcommands: 

/* (comment) 7-42 
abbreviations for C-6 
additional MAGNET 7-41 
CLOSE 7-61 
COPY 7-39, 0-1, C-4 
data definition and 
manipulation 7-6 
data transferral 7-37 
DECLARE 7-6, C-6 
DELETE 7-34, C-6 
DISPLAY 7-30, 7-31, C-6 
LIST 7-29, C-6 
LOAD C-6 
MAGNET 7-3 

MODIFY 7-32 to 7-34, C-6 
MOVE 7-38, 7-39, C-6 
NOISY 7-61 
POSITION 7-41, 7-42, 

C-l, C-2, C-6 
QUIT 7-42, C-6 

READ 7-37, C-l to C-3, C-6 

RENAME 7-32, C-6 
SILENT 7-61 

table of MAGNET 7-4, 7-5 
TRANSLATE 7-34, 7-35, A-l 
WRITE 7-37, 7-38, 

C-l, C-3, C-4 

Subsystems: 

MAGNET 7-1 

MAGRST 8-1, 8-7 to 8-22 

MAGSAV 8-1 to 8-7, 

8-13 to 8-22 

PHYRST 9-1, 9-15 to 9-25 
PHYSAV 9-1 to 9-15 

SUFD, MAGSAV option 8-2, 8-4 

Supply reel 1-8 

Swapping bytes in MAGNET 
7-52, 7-53 


Tables: 

BCD A-15 

character set A-6 to A-30 
EBCDIC A-ll to A-14 
industry-standard ASCII 
A-l, A-8 

Prime ASCII A-9, A-10 
translation A-16 to A-30 

Take-up reel 1-8 

TAPE 5-4 

Tape character 1-2 

Tape density settings 4-3 

Tape drive, described 1-8, 1-9 

Tape drive, diagrammed 1-9 

Tape drives, assigning by: 
logical device number 
4-4 to 4-6 

physical device number 4-4 

Tape drives, unassigning by: 
logical device number 4-8 
physical device number 4-8 

Tape file 1-6 

Tape format, logical 1-6 

Tape format, logical 
(diagrammed) 1-7 

Tape frame 1-2 

Tape label and file 

oonfigurations, diagrams 
3-12 to 3-15 

Tape marker 1-6, 2-7 

Tape reel, external features, 
diagrammed 7-27 

TAPE, MAGNET option 7-12 


Tapes: 

density of 1-2 
labelled 3-1 to 3-16 
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Level 1 3-11 

Level 2 3-11 

Level 3 3-11 

Level 4 3-11 

nine-track 1-2, 1-10 
nine-track, diagrammed 1-3 
positioning 7-41 
seven-track 1-2, 1-10 
seven-track, diagrammed 1-3 
unlabelled 3-16 to 3-20 

Tokens, edit A-l to A-6 

TPID, ASSIGN option 4-3, 4-6, 
C-6 

Tracks 1-2 

TRACKS, MAGNET option 7-13 

Trailer labels: 
defined 3-2 
EOFl 3-11 
EOF2 3-11 
EOF3-EOF9 3-11 
EOFn 3-1 

UTLn 3-1, 3-2, 3-5, 3-11 

TRANSLATE: 

MAGNET subcommand 7-34, 7-35 
subcommand line format 7-34 
used with edit tokens 
A-l to A-6 

Translation edit tokens, table 
of 7-36 

Translation tables: 

BCD to Prime ASCII A-16 
creating 7-59 to 7-61 
EBCDIC to Prime ASCII 
A-22 to A-24 

Prime ASCII to BCD A-17, A-18 
Prime ASCII to EBCDIC 
A-19 to A-21 
Prime ASCII to 
industry-standard ASCII 
A-28 to A-30 

TTY option: 

in MAGRST 8-7 

in MAGSAV 8-4 

in PHYRST 9-15 


in PHYSAV 9-3 
TYPE: 

LABEL option 6-1 
MAGNET option 7-58, 7-59 

UHLn 3-1, 3-2, 3-5, 3-6 

UNASSIGN command options: 

ALIAS ldi 4-8 
UNLOAD 4-8 

UNASSIGN: 

command 4-1, 4-8, 5-1 
command line format 4-8 
command messages 4-9 

Unassigning tape drives by: 
logical device number 4-8 
physical device number 4-8 

Uncompressed records 7-16 

Unlabelled tape file formats 
( See Unlabelled tape file 
configurations) 

Unlabelled tapes 3-16 to 3-20 
UNLOAD, UNASSIGN option 4-8 
UNM3D: 

PHYRST option 9-15 
PHYSAV option 9-3 

UPDT, MAGSAV option 8-3 

User (default) mode, in ASSIGN 
5-1 to 5-3 


USER option: 

in MAGNET 7-3, B-l, C-5 
in SETMDD 5-2 


USRNAM 

4-2 

USRNUM 

4-2 

UTLn 

3-1, 3-2, 3-5, 3-11 

UVLn 

3-1, 3-2 
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Vacuum chamber 1-8 
VAR, MAGSAV option 8-3 


Variable-length records: 

ANSI standard 2-2, 2-4 
ANSI standard spanned 2-5, 
2-6, 2-11 
defined 2-1 
IBM standard 2-2, 2-3 
IBM standard spanned 2-5, 2-8 
Prime 2-6 


Write-enable ring, use of with 
ASSIGN 1-2, 4-3 

WRITE: 

MAGNET subcommand 7-37, 7-38 
pre-Rev 18.3 C-l, C-3, C-4 
subcommand line format 7-37 






Variables, global 7-43 to 7-45 

VERSION, MAGNET option 
7-50, 7-51 

VISUAL, MAGNET option 7-26 

VOL, LABEL option 6-2 

VCLl 3-3, 3-4 

VCL2-VCL9 3-5 

VOLID, LABEL option 6-1, 6-2 

VCLn 3-1, 3-2 

VCLSER, LABEL option 6-1, 6-2 

Volume header label group 3-2, 

3-11 

Volume labels EOVn 3-2 

Volume labels: 
defined 3-1 
EOV1 3-11 

ECV2 3-11 

EOVn 3-1, 3-2, 3-11 

UVLn 3-1, 3-2, 3-5 

VCL1 3-3, 3-4 

VCL2-VCL9 3-5 
VCLn 3-1, 3-2 

VOLUME, LABEL Option 6-1, 6-2 

WAIT, ASSIGN option 4-3, 4-4 
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Introduction to Magnetic Tapes 







1 

Magnetic 

Tapes 


INTRODUCTION 

Magnetic tapes used in computer applications are similar to those used 
in tape, cassette, and cartridge recorders. Instead of recording 
music; however, computer tapes record digital information. This 
information can be almost anything — social security records, test 
results, a data base, or even an encyclopedia. 

Magnetic tapes are very inexpensive compared to other storage media 
such as magnetic disks and large dynamic RAM main memory. Of these 
three devices, data on tapes is the slowest to access, while main 
memory is the fastest. However, magnetic tapes can store more 
information per dollar than either memory or disk. For these reasons, 
computer storage is maintained as a hierarchy of seme amount of mam 
memory, an amount of disk storage, which is roughly one to three orders 
of magnitude larger than main memory and virtually unlimited tape 
storage. 


PHYSICAL CHARACTERISTICS 

Physically, a computer tape is a long, narrow piece of plastic film 
cited with iron oxide. K> record information, certain areas rf the 
coating are magnetized. The magnetization remainsuntil the tape is 
remaqnetized by recording new information over the old information or 
until the tape is passed through a bulk-erasing device. Because _baPf£> 
are susceptible to magnetic fields they must be stored carefully to 
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guard against either accidental or malicious destruction of 
information. 

Just like motion-picture film, computer tape is wound on a reel . The 
reel usually contains a removable ring on one side called the 
write-enable ring . (See Figure 7-4.) If the ring is removed, the tape 
can be read by the computer, but no information can be written. If the 
ring is not removed, the tape can be read or written. 

Dimensionally, a computer tape is 1/2 inch wide and from 600 to 2400 
feet long. (600, 1200, or 2400 feet are the usual standard sizes 
available from suppliers.) The tape reel is ordinarily made of plastic 
as is the write-enable ring* The tape is not threaded into the reel? 
instead, it is wound onto the reel until there is sufficient friction 
to prevent the tape from slipping. 


DENSITY, TRACKS, AND FRAMES 

The information on computer tapes is recorded as a series of magnetized 
flux changes which can be placed as close together as several hundred 
to several thousand per inch. The most common amounts are 200, 556, 
800, 1600, and 6250 per inch. This is called the tape density and is 
usually written as either bpi (bits per inch) or cpi (characters per 
inch). 

To store more information, computer tapes contain several parallel 
tracks, running the length of the tape. This is similar to stereo or 
quadrophonic audio recordings where a tape has several channels . 
Computer tapes usually contain either seven or nine tracks? a tape 
with seven tracks is called a seven-track tape . Nine-track tapes 
contain nine rows of magnetic spots (called bits ). 

Tracks run the length of the tape. Characters are written across the 
tape. That is, each character is recorded as a pattern of bits, one 
bit per track. The area needed to hold one bit per track across the 
width of the tape is called a tape frame (or tape character ). A 
seven-track tape frame has seven bits, one for each track, while a 
nine-track tape frame has nine bits, one for each of its nine tracks. 
Nine- and seven-track tapes are both the same width? nine-track tapes 
have narrower tracks. 

The various tape concepts just discussed are summarized in Figure 1-1. 
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MAGNETIC tapes 



Track P or C 
Track 2 or B 
Track 3 or A 
Track 4 or 8 
Track 5 or 4 
Track 6 or 2 
Track 7 or 1 



| = One Bit 


Track 4 
Track 6 
Track 0 
Track 1 
Track 2 
Track P 
Track 3 
Track 7 
Track 5 


Seven-Track Tape (A ), Nine-Track Tape (B) Formats 

Figure 1-1 
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RECORDS, GAPS, AND BLOCKS 


?!.^P uter ^ onl y f ead ^ write a certain number of frames during 
frf£2e le 4 -u Gad ? r Write operation. The minimum is usually about 10 
frST 7 *5® maxim V in on Prjjne computers is 12,288 frames. A group of 
frames read or written at one time is called a physical tape r ecord or 

Physical records are separated by inter-record gaps 
(^s) or "dead space where no useful information's recorded. The 
n ^ r T re °° rd g f P °° ntains no useful information and is at least 1/2 
^ h 311(3 my soinetirnes he as long as 3 inches. Records are 
preened by a preamble and followed by a postamble , which are both 

• th \? a f dware are not user " vis ible. The preamble alerts 
the tape drive that a record immediately follows, while the postamble 

signals that the end of a record has been reached. In addition, the 
postamble contains some "check" information used to validate whatever 
was just read or written. 

If you wish to write many small records, there will be a hiqh 
percentage of inter-record gaps on the tape. For example, if 
80-character records are written at a density of 800 bpi, the records 
will each occupy 1/10 of an inch. The IRGs will be at least five times 
as large as each record. The solution to this problem is called 
j oking . The maximum size of Prime tape records is 12,288 characters 
(12K bytes or 6K words). The 80-character logical records mentioned 
above could be "blocked" 153 per physical record . The blockinq factor 
in this case is 153. Forty-eight characters are unused, so the 
physical records written would be 12,240 characters long. When all 
lo ^ c f 1 reoords are the same size, they are called fixed-length 

Sl^ngth U1UStrateS 130,11 blocked — 

* ive " k ? OWS " of blocking; the 12,240 characters 
t0 one ij-arge physical record. User programs must perform the 

translations Unblocking of Pbysical-to-logical and logical-to-physical 
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Fixed Length Records (A) Unblocked (B) Blocked 

Figure 1-2 
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TAPE FILES 

Blocks, in turn, are grouped together to form a tape file . The file 
limits are marked or delimited by special control characters which can 
be placed on the tape. These characters are called file markers or 
tapp markers. A file marker is actually composed of about 3 inchesjof 
"dead" space followed by a special file marker control character. The 
entire file marker area is at least 4 inches long (the "dead" space 
area may be longer). The term for the "dead" space area plus the file 
marker control character is file marker gap , but the term file marker 
(or tape marker) will be used in this manual. 

When a tape contains blocks that are separated by file markers, the 
ta pp is said to have a logical tape format . The logical tape format is 
shown in Figure 1-3. 
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TAPE DRIVES 

Tapes are read and written by a machine similar to a tape recorder. 
Like a tape recorder, a tape drive has two hubs on which the supply and 
take-up reels are placed. The supply reel contains the tape to be read 
or written. Just as on a motion-picture projector, the take-up reel 
receives the tape after it has been read or written. 

As the tape is processed, it unwinds from the supply reel, passes 
through a vacuum chamber , moves under the read/write heads , passes 
through another vacuum chamber, around the capstan , and winds onto the 
take-up reel. The vacuum chambers ensure that there is never too much 
or too little tension placed on the tape. The capstan controls the 
tape speed. The read/write heads either read from or write information 
to the tape. In addition to these two operations, tape drives can 
rewind to the beginning of the tape, move forward or backward at 
several different speeds, provide status information about tape 
operations, and perform several other functions. 

A few feet after the beginning and a few feet before the end of the 
tape are two silver metallic strips called the beginning-of-tape (BOT) 
marker and the end-of-tape (EO T) marker . These markers are 
automatically sensed by the tape drive to ensure that the tape is never 
pulled off either reel. 

Tape density is set either by a switch on the tape drive itself, 
through a program on the computer, or both. These various tape drive 
features are shown in Figure 1-4. 

There are several other tape drive features that should be noted. One 
is the speed , measured in inches per second. This is the rate at which 
the tape drive can move the tape and is typically 45, 75, or 125 inches 
per second (ips ). The distance from the beginning-of-tape marker to 
the first inter-record gap is about 40 inches. The preamble and 
postamble have several different formats. These are called the 
phase-encoded (PE), non-return to zero in verted (NRZI) and group code 
recording (OCR) techniques. GCR is available only on 6250 drives on 
Prime systems; PE is available only at 1600 bpi; NRZI is available on 
800 bpi drives only. For more information regarding tape recording 
techniques, refer to the appropriate American National Standards 
Institute (ANSI) manuals listed in the bibliography. 
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PARITY 

Most computers store information in either six- or eight-bit "packets" 
called bytes . The Digital Equipment Corporation PDP-8 and several 
Control Data Corporation machines are examples of six-bit byte 

machines. All Prime computers, IBM's 360/370 series, and 
Hewlett-Packard's HP-2100 are examples of eight-bit byte computers. 
Seven-track drives were originally developed for six-bit byte 

computers, while nine-track drives were developed for eight-bit byte 

computers. In each case, there is one more track on the tape than 

there is in the computer byte. The extra track is called the parity 
track . Each tape frame thus has a parity bit . 

The parity bit is used as an additional "check" on the validity of the 
information stored on the tape. There are four possible ways a parity 
bit can be set: 

• Always on; error if a parity bit off condition occurs 

• Always off; error if a parity bit on condition occurs 

• Even parity; the data bits for a frame are added. If the 
result is even, the parity bit is set to 0, otherwise it is set 
to 1. 

• Odd parity; the data bits for a frame are added. If the result 
is even, the parity bit is set to 1, otherwise it is set to 0. 

Seven-track tapes can be read or written with either the even or odd 
parity selections. Prime tape drives always write odd parity for 
nine-track tapes. 


CHARACTER POPES 

The information stored in a byte may be of two types: a number or a 
character. Since a byte is eight bits, 256 different numbers or 
characters may be represented in one fcyte. The interpretation of the 
contents of a byte depends on the application program. In the case of 
characters, the user could assign any number to mean any character 
desired; however, there are already certain standard combinations that 
are widely recognized throughout the computer industry. Among these 
character codes are the American National Standard Code for Information 
Interchange (ASCII), the Extended Binary Coded Decimal Interchange Code 
(EBCDIC) and the Binary Coded Decimal Interchange Code (BCDIC or BCD). 

ASCII is the code used on Prime computers. EBCDIC is used on IBM 
systems and BCDIC is used primarily as a seven-track tape interchange 
code. To write information currently encoded in ASCII to a seven-track 
tape, it must first be translated to BCDIC, which is a six-bit code. 
Since ASCII is a seven-bit code (the extra bit is always a "1" on Prime 
systems), one half of all Prime ASCII characters cannot be translated 
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to BCDIC characters. Among these are lowercase letters and sane 
special characters. EBCDIC is an eight-bit code; one half of all 
EBCDIC characters, therefore, cannot be translated to ASCII. However, 
in practice, most of the "extra" EBCDIC characters are not used on IBM 
or Prime systems anyway. 

Sane characters cannot be readily translated to meaningful characters 
in another code. The solution is usually to translate to a character 
that will be recognized as an "untranslatable" character. 

ASCII is a seven-bit code fully defining 128 characters. However, most 
computers that use ASCII have eight-bit bytes. Prime software sets the 
remaining (high-order) bit to a 1. This fact must be kept in mind 
whenever transferring information between Prime systems and other 
ASCII-based systems that set high-order bits to 0. 


BINARY PACKING AND UNPACKING 

Connecting nine-track drives to six-bit byte sized computers presents 
no problems when writing because the extra two bits can be set to 0. 
Read operations, however, will almost certainly cause problems with 
loss of data. On eight-bit byte computers, seven-track drives present 
no problems when reading, but a write operation will cause a loss of 
data because two bits are ignored. 

Seven-track drives may be connected to Prime systems. There are 
several methods of communicating with seven-track drives, including 
character-code translation (previously discussed) and binary 
packing/unpacking . 

Numeric data occupies 16 bits (two bytes or one word) on Prime systems. 
The range of values is -32768 to +32767. A computer with six-bit bytes 
(connected together two per word) can only store numbers in the range 
-2048 to +2047. To translate numeric information, binary 
packing/unpacking is employed. 

A computer word of 16 bits can be divided into either three or four 
pieces, each six bits or fewer. The choices are shown in Figure 1-5. 

The three-frame formats do not need a fourth frame, so the next word 
can be placed starting in that frame. Any frame that only has four 
valid bits can record the other two bits as anything. As long as the 
computer is told what format is being used, it will correctly ignore 
any extra bits. Of course, the problem with the binary formats is that 
the computer words which were 16 bits long are now three seven-track 
tape frames long which still occupy three eight-bit bytes or 24 bits 
total, internal to the computer's memory. The unpacking is usually 
performed inside the computer so that records which were "n" bytes long 
are expanded to 3*n/2 bytes for three-frame formats, and to 2*n bytes 
for the four-frame format. 
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Record 

Formats 


INTRODUCTION 

Chapter 1 dealt with the physical aspects of magnetic tapes, such as 
bits, frames, records, files, tracks, and density. This chapter deals 
with logical records and logical record length . 

Records, whether stored on magnetic disks or tapes, cards or paper 
tape, come in one of two forms: either fixed-length or 
variable-length . Fixed-length records are all the same size. If user 
data does not completely fill a fixed-length record, empty character 
positions are usually set to blanks or 0's. Variable-length records, 
however, can range in size from zero characters to some maximum. Both 
fixed- and variable-length records may be blocked on magnetic tapes. 

Under PRIMDS, the maximum size of a magnetic tape transfer is limited 
to 6144 words (or 12,288 bytes or characters). Thus, the maximum size 
of a fixed-length record is 12,288 characters if the blocking factor is 
1. If the record size is decreased, the blocking factor may increase: 
a record size of 80 characters permits a blocking factor of 153 with 48 
characters wasted. 

Variable-length records can be written in many different forms: IBM 
standard variable , American National Standards Institute (ANSI) 
standard variable , IBM standard spanned , ANSI standard spanned . Prime 
variable-length and break . Each of these formats will be discussed in 
this chapter. 


2-1 


First Edition 

















DOC5027-183 


Standard Fixed-Length Records 

The maximum size of fixed-length records under PRIMDS is 12,284 
characters. Figure 1-2 in Chapter 1 illustrates this format. All 
records in a file containing fixed-length records must be the same size 
except for the last record which may be smaller. 


IBM Standard Variable-Length Records 

The maximum size of an IBM variable record under PRIMDS is 12,280 
characters. Smaller maximum size limits result in larger possible 
blocking factors. The format for this type of record is a 
four-character block control word (BCW) followed by records. As shown 
in Figure 2-1, each record is composed of a four-character record 
control word (ROW) and data. 

In the diagram, the data portion of one record is given as "J" while 
the other data record's length is given as "K". These two lengths are 
not necessarily equal. The only constraint is that the sum of the BCW, 
all of the RCW's, and all of the data portions must not exceed 12,288 
bytes. 

The BCW contains the length of the entire physical block or record. 
The length is stored as an unsigned 16-bit integer in the first two 
bytes. The second two bytes are reserved and must be set to 0. It is 
important to note that the BCW includes the length of the BCW itself, 
which is four bytes. Also, on IBM systems, this number should be 
between 8 and 32,760. The RCW has the same format as the BCW, but this 
length is the length of each logical record plus the length of the RCW 
(four bytes). 


ANSI Standard Variable-Length Records 

The maximum size of an ANSI variable record under PRIMDS is 12,284 
characters. Smaller maximum size limits result in larger possible 
blocking factors. This format is similar to the IBM variable-length 
format except that there is no block control word (BCW). As shown in 
Figure 2-2, each record is still composed of an RCW plus a data 
portion. 

In the diagram, the data portion of one record is given as "J" while 
the other data record's length is given as "K". These two lengths are 
not necessarily equal. The only constraint is that the sum of the 
RCW's and all of the data portions must not exceed 12,288 bytes. The 
format of the MSI RCW is not the same as IBM's RCW. The length is an 
integer, recorded as a four-byte character string, which completely 
fills the RCW. There are no corresponding reserved bytes as there are 
in the IBM format. 


First Edition 


2-2 










RECORD FORMATS 


Length of Fields in Characters 




j 

5 

K 

yy 

s 


S 



c 

w 

Data 

y 


Data 

t • • V 

s 



One Block 





File Marker 


Beginning and/or End of Tape Marker 
Inter-Record Gap 


IBM Standard Variable-Length Records 
Figure 2-1 jo 


2-3 


First Edition 




















DOC5027-183 


Length of Fields in Characters 




File Marker 

Beginning and/or End of Tape Marker 
Inter-Record Gap 


! H 

ANSI Standard Variable-Length Records 
Figure 2-2 / 


First Edition 


2-4 



















RECORD FORMATS 


TPM Standard Spanned Variable-Length Records 

Spanned records are similar to the standard variable-length records. 
Logical record lengths greater than the FRIMOS physical length maximum 
are possible because a logical record may be continued over two or more 
physical records. In other words, a 100,000-byte logical record would 
be written on tape as eight physical tape blocks, each containing the 
12,288-byte maximum, and a ninth block containing some fragment. Each 
"piece" of the logical record is called a segment . Instead of a record 
control word, each segment is preceded by a segment control word (SOT). 
The SCW contains two pieces of information: the length of the data 
segment, including the SCW itself, and a segment descriptor . The 
format of the IBM SCW is shown in Figure 2-4. The SCC within the 
segment descriptor indicates whether the associated segment is the 
first segment of the logical record, the last segment, a middle piece, 
or the entire logical record. Figure 2-3 illustrates this IBM record 
format. , 

Spanned records may be blocked. However, no more than one segment of a 
record may appear in a block. In Figure 2—3, the data segment with 
length "J" would be the last segment of a record, while the data 
segment with length "K" is either the first or only segment of that 
record. 

The SCC is one byte (eight bits) long. The first (high-order) six bits 
are 0 and the last two bits specify the relative position of the 
segment. Table 2-1 lists the SCCs and the corresponding segment 
positions. 

Like IBM variable-length records, IBM spanned records contain a block 
control word. The format is exactly the same as in variable-length 
records. 


ANSI Standard Spanned Variable-Length Records 

Spanned records are similar to the standard variable-length records. 
Logical record lengths greater than the PRIMOS physical length maximum 
are possible because a logical record may be continued over two or more 
physical records. In other words, a 100,000-byte logical record would 
be written on tape as eight physical tape blocks, each containing the 
12,288-byte maximum, and a ninth block containing seme fragment. Each 
"piece" of the logical record is called a segment . Instead of a record 
control word, each segment is preceded by an SOT. The SOT contains two 
pieces of information: the length of the data segment, including the 
SOT itself, plus a segment descriptor . The SCC within the segment 
descriptor indicates whether the associated segment is the first 
segment of the logical record, the last segment, a middle piece, or the 
entire logical record. The ANSI spanned format is very similar to the 
IBM spanned format, except that there are no block control words on 
each physical block and the segment control word has a slightly 
different form. Figure 2-5 illustrates the ANSI spanned format. 
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Spanned records may be blocked. However, no more than one segment of a 
record may appear in a block. In Figure 2-5, the data segment with 
length "J" would be the last segment of a record while the data segment 
with length "K" is either the first or only segment of that record. 
Note that the ANSI segment control words are each five bytes long. The 
format of the ANSI SOW is shown in Figure 2-6. 

The SCX: is one byte (eight bits) long and is a character instead of a 
binary number as in the IBM SCC, and indicates the relative position of 
the segment within a multisegment record. Table 2-2 lists the SCCs and 
the corresponding segment positions. 


Prime Variable-Length Format 

Prime variable-length format provides Prime FORERAN and FL/I users with 
a variable-length capability that is easier to use than the standard 
formats. In this format, a physical record is equivalent to a logical 
record (a blocking factor of one). Whatever is contained in a physical 
tape record actually becomes one logical record. No block, record, or 
segment control words are necessary, but the maximum record size is 
limited to 12,288 bytes. 


Break Format 


Break format is similar to Prime variable-length format except that 
logical records are not constrained to "fit" into one physical record. 
The end of a logical record is "signalled" fcy a carriage- 
return/line-feed (CRLF). Two consecutive CRLFs indicate a completely 
blank line. No record, block, or segment control words are necessary, 
and a logical record has no size limit. The physical tape records are, 
however, limited to the Prime maximum of 12,288 bytes. 


MAGNETIC TAPE STANDARDS 

There are two standards for magnetic tape formats. One is a de facto 
standard used by IBM and recognized by many manufacturers when 
interchanging tapes with IBM computers. The other is a more formal 
standard, developed by ANSI. 


IBM Format 

Use of the IBM standard implies that nine-track tapes are recorded in 
EBCDIC, while seven-track tapes are recorded in BCDIC. The density for 
nine-track tapes is 800, 1600, or 6250 bpi while seven-track tapes are 
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recorded at either 200 , 556, or 800 bpi. Variable-length IBM records 
are preceded by an RCW of four bytes. The first two bytes contain the 
length of the record including the RCW. The second two bytes are not 
used. Variable-length records may be blocked. Spanned records are 
preceded by an SCW of four bytes. The first two bytes indicate the 
length of the record segment including the SOtf. 

The first four bytes of every variable or spanned block on IBM tapes 
contain a BCW. The BCW contains the length of the block plus the BCN. 


ANSI Format 

ANSI tapes are very similar to IBM tapes except that support of 
seven-track tapes is not specified. In addition, there is no BCW for 
variable or spanned records and the RCWs and SGtfs are slightly 
different. The RCW is four bytes long and contains the length of the 
record including the RCW as a four-byte-fixed binary (31) or 
integer*4-number. The SCW is five bytes long. 

ANSI standard tapes are written using the ASCII character set. Binary 
tapes contain binary numbers. Different computer manufacturers 
represent binary numbers in different ways. For example, some 
computers use ones complement notation, while others use twos 
complement notation. The IBM System 360/370 computers have a four-byte 
floating point format which uses base 16. The exponent occupies seven 
bits of the first byte. Prime has a four-byte binary floating-point 
format in which the exponent occupies the last byte. Because of these 
differences, binary tapes are usually not transportable from one 
manufacturer's computer to another. 

Consecutive segments of a spanned record can be split between two tape 
reels because of their segment indicators. The end of information on a 
tape that is part of a multireel file is signalled by a tape marker . 
The end of information on the last tape volume of a multireel file or a 
single volume is indicated by two tape markers written one immediately 
following the other. Files are separated by a single tape marker. The 
first file on a reel, which is the first or only reel, is not preceded 
by a tape marker. 
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Table 2-1 

IBM Segment Control Codes 


Code 

Relative Position of Seqment 

00 

Complete logical record 

01 

First segment of a multisegment record 

10 

Last segment of a multisegment record 

11 

Middle segment of a multisegment record 
(not the first or the last) 
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Length of Fields in Characters 
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ANSI Standard Spanned Variable-Length Records 
Figure 2-5 
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Length in Characters 



(SCC) 


ANSI Segment Control Word (SOW) 
Figure 2-6 
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Table 2-2 

ANSI Segment Control Codes 


Code Relative Position of Segment 

0 Complete logical record 

1 First segment of a multisegment record 

2 Middle segment of a multisegment record (not the 
first or the last) 

3 Last segment of a multisegment record 
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Labels 


INTRODUCTION 

Tape labels are used to identify and provide processing information 
about tape reels and the files they contain. As with record standards, 
there are basically two tape label standards. The first is the de 
facto standard of IBM. The second is an ANSI standard. The two 
standards are almost the same, differing only in the naming or length 
of certain fields within a label. The major difference is that IBM 
labels are written in either nine-track EBCDIC or seven-track BCDIC, 
while ANSI labels are written in nine-track ASCII only. 

Labels are just tape records. They are usually 80 characters long. 
The first four characters identify the label type . There are several 
different label types: 

• Volume labels - VGLn, UVLn, EOVh 

• Header labels - HDRn, UHLn 

• Trailer labels - EOFn, OTLn 

Volume labels identify the reel of tape, the owner of the reel, and the 
accessibility of the reel. Other information may be stored in user 
fields. 
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Header and trailer labels identify and provide information about each 
file on the tape. Such information includes the file-identifier, the 
creation and expiration dates, block counts and set, sequence, 
generation and version numbers. 


VOLUME LABELS 

There are three types of volume labels: VCLn, UVLn, and EOVn labels. 


VOLn Labels 

VOLn labels appear at the very beginning of a reel of tape. There may 
be 15 ) to nine of these labels, numbered VOLl through V0L9. If the tape 
has any standard labels at all, it must have a VOLl label as its first 
record. There need not be more than one VOLn label, but if there are 
any additional VOLn labels, they must appear in sequence, VCL2, VCL3, 
etc. Certain IBM operating systans allow only up to eight of these 
labels (VOLl - V0L8). The format of the ANSI standard VOLl label is 
shown in Figure 3-1. The format of the IBM standard VOLl label is 
shown in Figure 3-2. 


Other Volume Labels, User File Header, and User File Trailer Labels 

The format of the IBM and the ANSI V0L2 through V0L9, as well as the 
UVLl through UVL9, UHLn, and UTLn labels are shown in Figure 3-3. Sane 
IBM systems limit the number of VOL and UVL labels, and it is best to 
check first when writing tapes that are targeted for IBM systans. The 
UVL labels immediately follow the last of the VCL labels on the tape. 
The VOL-UVL label group is called the volume header label group . 
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CONTENTS OF FIELDS 

The String ' VOL 1" 

Volume Serial Identifier (VOLSER) - identifies a specific reel of tape 


Accessibility — an installation-dependent field indicating the type of reel access. A space indicates no 
restrictions. Other characters may indicate read-only, execute-only. etc. 


Reserved by ANSI for future information; recorded as spaces. 


Owner-Identification — identifies the owner of the reel. 


Reserved by ANSI for future information; recorded as spaces. 


ANSI Standard Version — recorded as a “3" to indicate that Prime software conforms 
to the X3.27-1978 standard. 


ANSI Standard VOLl 


Figure 3-1 
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CONTENTS OF FIELDS 


The String “Vol. 1" 


Volume Serial Identifier (VOLSER) — identifies a specific reel of tape. 


Reserved by IBM for future information; recorded as spaces. 


Owner Identification — identifies the owner of the reel. 


Reserved by IBM for future information; recorded as spaces. 


IBM Standard VQLl Label 
Figure 3-2 
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CONTENTS OF FIELDS 

The String "VOLn" (n = 2 - 9), 

“UVLn" (n = 1 - 9), 

“UHLn" (n * 1 - 9) or 
'‘UTLn” (n = 1 - 9) 


This is a user-specified field. It is not checked or processed by Prime magnetic tape 
subroutines or subsystems. 


IBM & ANSI VQL2-VQL9 and UVLn, UHLn, and UTLn Labels 

Figure 3-3 
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FILE HEADER LABELS 

There are two types of FILE HEADER labels: the HDRn and the UHLn 
labels. 


HDRl and HDR2 Labels 

A labelled tape must include at least a HDRl label before each file. 
Up to nine HDRn labels may appear, but just like VOLn labels, they must 
appear in order. The first UHLn label must appear, if at all, after 
the last HDRn label. A collection of HDRn and UHLn labels appearing 
together is called a file header label group . Figure 3-4 shows the 
format of the ANSI standard HDRl label. Figure 3-5 shows the format of 
the IBM standard HDRl label. The HDR2 label contains additional 
information about the tape file. Once again, the IBM and ANSI labels 
have some differences. Figure 3-6 shows the format of the ANSI 
standard HDR2 label. Figure 3-7 shows the format of the IBM standard 
HDR2 label. 


Other File Header Labels 

All of the other HDRn (n = 3, 4, 5, 6, 7, 8, and 9) labels and all of 
the UHLn labels follow the same format as the VOLn (n = 3-9) and UVLn 
labels. The first four characters contain the label identifier, and 
the other 76 characters are reserved for the user. The 
beginning-of-file label group is terminated by a single file marker. 
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MAGNETIC tape labels 


Character 

Position Length 


-T" 


2 

A 

3 


4 


5 

\ 

6 


7 


8 


9 


10 


11 


12 

tl 

13 

1/ ► 

14 


15 


16 


17 


18 


19 


20 


21 


22 


23 

C 

24 

0 

25 


26 


27 


00 

CM 


29 

A 

30 


31 


32 


33 
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34 


35 


36 


37 


38 

4 z 

39 


40 
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43 

c 

44 
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45 


46 


47 


48 


49 


50 

G 

51 

b 

52 


53 


54 
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55 


56 


57 

c___ . 

58 

0 

59 


60 


61 


62 


63 


64 


65 

10 

66 

U 

67 


68 


69 


70 


71 


72 


73 


74 


75 

_0--- 

76 

7 ~ 

77 


78 


79 


_22- 



CONTENTS OF FIELDS 

The String “HDR1" 


File-Identifier - identities individual tape files 


File-Set Identifier — the same information as that in the volume-identifier field on the VOL 1 label 
For multi-volume files, it contains the volume identifier of the first tape reel of the set. 

File-Section Number — identifies the order of a particular reel in a multi-reel set ("0001 - 9999 ). 

File-Sequence Number - identifies the order of a file within a set of files created simultaneously 
("0001" - "9999"). 

Generation-Number - indicates file generation or edition ("0001 "-"9999") or spaces). 
Generation-Version — indicates file version or printing ("00 "99 or spaces). 


Creation Date — the day and year the file was created. The format is "JSyyddd" where 

t = a blank 


yy = the year ("00"-"99") 
ddd = the day of the year ("00"-"366") 


Expiration-Date — the day and year the file expires. The format is the same as that 
for the creation date field. 

Accessibility — is installation dependent. 


Block Count - recorded as "000000" 


System Code — identifies the computing system that wrote the file, Prime software 
writes the string "PRIM0S^)<)«|«" where the "/"'s represent spaces. 


Reserved by ANSI for future information; recorded as spaces. 


ANSI Standard HDRl Label 
Figure 3-4 
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Character 

Position _Length 




2 

L A _ _ ( 

a 

L __ 4 ( 


L_ ) 



6 

I 

7 

I 

8 

1 
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1 

10 

I 

11 

/ 

12 
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13 

I 17 - \ 

14 


15 

[ 

16 

i 

17 

i 

18 

1 

19 

l 

20 

| 

21 

1 

22 


23 

) 

24 

r ( 

25 

6 > 

26 

~~ ( 

27 

) 

28 


29 
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30 
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37 
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64 
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/ 

74 
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75 
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76 

_T_ f 

77 


78 


79 
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SO.. 
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CONTENTS OF FIELDS 

The String "HDRI" 


Data Set-Identifier — identifies individual tape files. 


Data Set Serial Number - the same information as that in the Volume-Identifier field on the VOL 1 
label. For multi-volume files, it contains the volume identifier of the first tape reel of the set. 


Volume Sequence Number — identifies the order of a particular reel in a multi-reel set 
(•‘0001’-‘‘9999’). 


Data Set-Sequence Number — identifies the order of a file within a set of files created simultaneously 
(0001 -“9999”). 


Generation-Number - indicates file generation or edition (“0001 ” "9999" or spaces). 


Generation-Version - indicates file version or printing (“00“-“99” or spaces). 


Creation Date - the day and year the file was created. The format is “rfyyddd" where 

J6 = a blank 

yy * the year (“00“-“99“) 
ddd ■ the day of the year (“001 "-“366”) 


Expiration-Date - the day and year the file expires. The format is the same as that for 
the Creation Date field. 


Accessibility — is installation dependent. 


Block Count - recorded as “ 000000” 


System Code - identifies the computing system that wrote the file, Prime software 
writes the string “PRmsmmt" where the “jrf“ * s represent spaces. 


Reserved by IBM for future information; recorded as spaces. 


IBM Standard HDRI Label 
Figure 3-5 
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MAGNETIC TAPE LABELS 


Character 

Position Length 
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CONTENTS OF FIELDS 


The String “HDR2” 


Record Format — “F” = fixed length; 

“D“ * variable length; 

“S“ * spanned length. 

Block Length — maximum number of characters in a block. 


Record Longth - actual length of fixed-length logical records; maximum length including RCWs of 
variable-length logical records; maximum length excluding SCWs of spanned logical records 
(a record length of “00000” may indicate a record length > “99999"). 


Reserved by ANSI for future information; recorded as spaces. 


Buffer-Offset — length in characters of any field preceeding the first record in a block. 


Reserved by ANSI for future information; recorded as spaces. 


ANSI Standard HDR2 Label 
Figure 3-6 
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Character 



IBM Standard HDR2 Label 
Figure 3-7 
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MAGNETIC TAPE LABELS 


FILE AND VOLUME TRAILER LABELS 


The BOF1 label follows exactly the same format as the HDRl label except 
that the block count field contains the number of blocks that were 
written in the file., The E0F2 label follows exactly the same format as 
the HDR2 label. EOF3-EOF9 and UTLn labels follow the same format as 
VCL3-VOL9 and UVLn labels. The first four characters identify the 
label type and the other 76 characters are reserved for the user. 
There is no limit on the number of UHLn or UTLn labels that may be 
used. 

The EOVh labels are written whenever it becomes necessary to mount 
another tape when a currently mounted tape has reached its EOT marker. 
While it is theoretically possible for a user to provide E0V3-E0V9 as 
well as UTLn labels. Prime software will not allow this at this time. 
On an EOT during output, the E0V1 and possibly E0V2 labels are written, 
followed by the appropriate number of file markers and then the tape is 
rewound. The E0V1 format is the same as the E0F1 format. The B0V2 
label is the same as the E0F2 label except for the "EOV2" identifier. 


LABEL GROUPS 


Tape labels are written together in groups called label groups . The 
first information that must appear on a labelled tape is the volume 
header label group . Volume labels consist of at least the VOLl label. 
VUL2 through V0L9 labels may also be present followed by UVLl through 
UVL9, if desired. The next information that appears on the tape is the 
first file's file header label group , which consists of a HDRl label 
possibly followed by HDR2 through HDR9 and any number of UHL labels. 
These labels are followed by a file marker, then the actual data 
records for the file. The file is followed by: a file mark, an 
end-of-file label group consisting of E0F1 and possibly B0F2 through 
E0F9, and then any number of UTLn labels. If the file does not fit on 
one physical tape, the EOFn labels are replaced by EOVh labels. The 
last labels for a file are followed by a single file marker unless the 
file is the last file on the tape and ends before the end-of-tape 
marker, in which case two marks are written. The label and tape file 
formats are shown in Figures 3-8, 3-9, 3-10, and 3-11. 

If all the file header and file trailer groups on a tape contain only 
HDRl and BOF1/E0V1 labels, then the tape is said to have Level 1 labels 
only. If the tape contains HDR2 and EOF2/EOV2 labels in addition to 
the Level 1 labels, the tape is said to contain Level 2 labels . A tape 
that contains Level 2 labels and HDRn, EOFn, EOVh (n>2), UHLn, or UTLn 
labels is said to contain Level 3 labels . The terms Level 1 tape . 
Level 2 tape , and Level 3 tape are also sometimes used. A Level 4 tape 
may contain all Level 3 labels plus spanned records. 
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File Marker 

Beginning and/or End of Tape Marker 
Inter-Record Gap 


Tape Label and File Configuration — Single Reel, Single File 

Figure 3-8 
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MAGNETIC TAPE LABELS 




File Marker 

Beginning and/or End of Tape Marker 
Inter-Record Gap 


Tape Label and File Configuration — Multiple Reels, Single File 

Figure 3-9 
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File Marker 

Beginning and/or End of Tape Marker 
Inter-Record Gap 


Tape Label and File Configuration — Single Reel, Multiple Files 

Figure 3-10 
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MAGNETIC TAPE LABELS 



V u 

H U 

0 V 

OH 

& 

& 

L L 

R L 

n n 

n n 


Second Part of 
Second File 





File Marker 

Beginning and/or End of Tape Marker 
Inter-Record Gap 


Tape Label and File Configuration — Multiple Reels, Multiple Files 

Figure 3-11 


3-15 


First Edition 






























DOC5027-183 


UNLfiRRT.T.Kn TAPES 

Unlabelled tapes also follow certain standard formats; nevertheless 
they are harder to process than labelled tapes. There are two reasons 
for this; 

• Tape labels contain much of the information about record formats 
and lengths, blocking factors, and multireel operations. 

• Tape labels provide some protection for error checking and 
delimit data files better. That is, the labels contain 
information about how many tape blocks are contained in the 
file, and files are delimited by four file markers — two at 
each end (one before and after the HDRn label group, another set 
around the EOFn or EDVn group). 

On unlabelled tapes, the end of a file is signalled by a single file 
marker. If the end of a file is also the end of all the data on the 
tape, another file marker is written. If the end-of-tape marker is 
detected when writing, a single file marker is written whether or not 
the entire file has been written to tape. It is assumed that another 
tape must be mounted to complete processing. Unlabelled tape file 
formats are shown in Figures 3-12, 3-13, 3-14, and 3-15. 
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Tape File 




File Marker 



Beginning and/or End of Tape Marker 



Inter-Record Gap 


Unlabelled Tape File Configuration — Single Reel, Single File 

Figure 3-12 
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File Marker 

Beginning and/or End of Tape Marker 
Inter-Record Gap 


Unlabelled Tape File Configuration — Single Reel, Multiple Files 

Figure 3-13 
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MAGNETIC TAPE LABELS 


First Part of File 





File Marker 

Beginning and/or End of Tape Marker 
inter-Record Gap 


Unlabelled Tape File Configuration — Multiple Reels, Single File 

Figure 3-14 
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File Marker 

Beginning and/or End of Tape Marker 
Inter-Record Gap 


Unlabelled Tape File Configuration — Multiple Reels, Multiple Files 

Figure 3-15 
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PART II 


PRIMOS Magnetic Tape 
Commands 






4 

User Control 
of Tape Drives 


INTRODUCTION 

Various PRIMDS commands allow you to control tape drives so that you 
may perform different magnetic tape operations. Hie STATUS DEVICE 
command lets you check the availability of tape drives. Hie ASSIGN 
command allows you to gain control of a physical or logical tape drive 
or request that the operator give you assistance when you need special 
features. 

The UNASSIGN command lets you relinquish control of a tape drive. 


HIE STATUS DEVICE COMMAND 

Hie STATUS DEVICE command allows you to see which physical devices 
(tape drives) are currently in use. Hie output displays physical and 
logical device numbers for any assigned magnetic tape drives. Tape 
drives which are not assigned are not printed in the output. Hie 
format for the STAHJS DEVICE command line is: 

STAHJS DEVICE 
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A typical display might be: 


OK, STATUS DEVICE 


DEVICE 

WTO 

MT1 


USRNAM 

ADLEY 

PARIS 


USRNUM 

1 

13 


LDEVICE 

MTO 

MT2 


where: 


DEVICE 

The physical device number. 


USRNAM 

The login name of the user to whom the 
assigned. 

device is 

USRNUM 

The user number of that user. 


LDEVICE 

The logical device number being used for 

the drive. 


THE ASSIGN COMMAND 

The ASSIGN command allows you to gain complete control over a magnetic 
tape drive. You may either specify a particular drive by device number 
(for example, MTO), or request any drive that meets specified 
requirements. ASSIGN also allows you to make special requests of the 
operator; for example, removing the write-enable ring or mounting a 
tape (both useful in batch jobs). 

The command line format for ASSIGN is as follows: 

ASSIGN j MTpdn [-ALIAS MTldn] ) [-option(s)] 

I MTX -ALIAS MTldn J 

The arguments and options are: 


Argument Meaning 

MTpdn Identifies the magnetic tape (MT) unit number 

from 0 to 7, inclusive, pdn is the physical 
device number assigned to each drive at system 
startup. Numbers can be obtained from the 
systan operator. 

MTX Tells the operator to assign "any available 

drive"; must be accompanied by -ALIAS MTldn, 
which assigns a number (alias) to the drive for 
reference purposes. The actual drive assigned 
depends on any other options that appear on the 
command line. 
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-ALIAS MTldn Identifies the logical drive number, from 0 to 
7, inclusive. ldn is a user-specified number 
assigned to a particular physical drive unit; 
used as an alias for the pdn in subsequent 
magnetic tape operations. 

If this option is not specified, the logical 
device number is set equal to the physical 
device number. 


Note 


When MAGSAV and MAGRST ask the user for 
the device number of the drive on which 
a tape is mounted, they are requesting 
the logical device number. If the 
-ALIAS option was used, the logical 
device number will differ from the 
physical device number. Otherwise, 
they will be identical. 


-WAIT Indicates that you are willing to wait until 

requested drive is available. 

-TPID id Requests the operator to mount a particular 

reel of tape, identified by a tape id, which 
can be up to eight characters long. Use of 
this control argument requires operator 
intervention, id is a list of tape identifiers 
(arguments) describing a particular reel of 
tape, and/or type of tape drive (name, number, 
etc.). Identifiers should not begin with a 
hyphen (-), which is a reserved character 
indicating the next control argument on the 
ASSIGN command line. Identifiers which begin 
with a hyphen, or which contain spaces or other 
reserved characters, must be placed inside 
quote marks. 

-RINGON Read and write both permitted. 


-RINGOFF Read only; write protection in effect. 


These options require operator intervention for 
removal or addition of the write—enable ring. 


-DENSITY 

4 


80 0 1 
1600 
3200 


U>250j 


Particular tape density settings are requested 
with these options. Most drives can handle 800 
and 1600 bpi settings. Sets density automati¬ 
cally on Version 3 (6250 bpi) drives; requires 
operator intervention on older drives. 


18.4 

19.0 
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-7TRK 

-9TRK 

Indicates seven- or nine- 
default is nine-track, 
intervention. 

-MOUNT 

Indicates that a new tape is 
already assigned tape drive, 
intervention. 


track tape drive; 
Requires operator 


to be placed on an 
Requires operator 


Assigning Tape Drives 

You may assign magnetic tape drives in any one of three ways: 

• By physical device number (pdn): 

ASSIGN MTpdn [options] 

• By logical device number (ldn): 

ASSIGN MTX -ALIAS MTldn 

• By logical device number plus characteristics: 

ASSIGN MTX -ALIAS MTldn -options 


Assigning Drives by Physical Device Number : When you assign a tape 
drive by a physical device number, you are requesting that particular 
tape drive. If the drive is unavailable, the option -WAIT queues your 
request. In the following example, you assign magnetic tape drive MTl. 
(1 is the physical device number.) This is the default assignment, and 
it requires no operator intervention: 


OK, ASSIGN MTl 
Device MTl Assigned. 
OK, 


When you assign a physical device, you may specify an alias if you 
wish. However, you are still requesting a particular drive. In the 

following example, you specify physical device MT6 to be loqical device 
MT2: 


OK, ASSIGN MT6 -ALIAS WT2 
Device MT6 Assigned. 

OK, 

Note that the physical, not the logical, device number is returned, 
ldn's and pdn's are associated internally in a special table and can be 
used interchangeably, if you do not request an ldn alias, the default 
logical device number is the same as the physical device number of the 
drive. 
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Assigning Drives by Logical Device Number: When you assign a tape 
drive by" a logical device number, you are requesting any tape drive and 
calling it number ldn. (You specify the number with the -ALIAS 
option.) Any free tape drive may then be assigned. This method of 
assigning tape drives maps physical device numbers into logical device 
numbers. This is especially useful if you have set up a ODmmand file 
with various commands referring to a particular magnetic tape unit. 
Assigning a tape unit an alias makes the unit known inside the command 
file. This logical tape assignment process: 

• Provides mapping between physical and logical device numbers. 
You may arbitrarily assign a tape drive by supplying the drive 
characteristics. If the particular drive is unavailable, you 
can use another drive with the same characteristics. 

• Allows and optionally requires operator intervention in tape 
unit assignment. 

• Allows you to request operator assistance in mounting a tape or 
performing other tape operations. 


Note 


Once you have specified a particular number for an ldn , you 
cannot assign another drive by that number. Just as each pdn 
refers to a unique drive, so each ldn must refer to one drive 
only. For example, if ADLEY assigns MTl with an alias of MTO, 
she cannot then assign MTO as itself: 

OK, STAT DEV 

DEVICE USRNAM USRNUM LDEVICE 


OK, ASSIGN WT1 -ALIAS WTO 
Device MTl assigned. 

OK, ASSIGN MTO 

The device is in use. MTO (asnmt$) 


In order to assign drive MTO, ADLEY must give it also an alias. 
For example: 


OK, ASSIGN KTO -ALIAS MT2 
Device MTO assigned. 

OK, STAT DEV 

DEVICE USRNAM USRNUM LDEVICE 
MTO ADLEY 15 MT2 
MTl ADLEY 15 MTO 
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18.4 

19.0 


18.4 

19.0 


Assigning Drives b y Logical Device Numbers Plus Characteristics: When 
you assign a tape drive by a logical ' device ■'number plus 
characteristics, you are asking for any drive that can handle a 
particular type of tape (for example, a nine-track tape at 6250 bpi). 
You give this drive a logical alias. Mote the following example: 

OK, ASSIGN OTTX -ALIAS MTO -TPID ABC -9TRK -RINGON -DENSIT Y 6250 

In this example, you wish to assign any drive with the following 
characteristics: nine—track; read and write (no protect); and 6250 
bpi. You wish to mount tape ABC on the drive if a drive is assigned. 
MTO is the number you will use to refer to the assigned drive. All 
subsequent tape operations of the assigned drive will use MTO as the 
unit number, if for any reason no drive is assignable, you will see an 
error message. 


Mounting Tapes : When you assign a tape drive, you may also specify a 
particular tape to be placed on the drive by using the -TPID control 
argument. Sometimes, it is necessary to have one tape removed from the 
tape drive and another tape placed or mounted on the tape drive. This 
is done by using the -M3UNT control argument. To specify -MDUMT, the 
tape drive must already be assigned. For example, suppose ADLEY, user 
number 6, assigns logical drive 7: 

OK, ASSIGN MTO -ALIAS MT7 -DENSITY 800 -TPID GRADES 
OK, 

Now suppose ADLEY reads or writes the tape with id GRADES, and then 
wants another tape mounted. The command line would be: 

OK, ASSIGN -ALIAS MT7 -MDUNT -TPID EXAMS 
OK, 

The operator receives a message at the syston terminal indicating that 
user ADLEY wants tape EXAMS mounted. The operator responds to ADLEY's 
request by using the REPLY command. (See Chapter 5, Operator Control 
of Tape Drives .) ADLEY then receives a message indicating whether or 
not the mount operation was successful. The mount operation might be 
unsuccessful, for example, if the operator could not find the requested 
tape. 


ASSIGN Canmand Message s 

Messages you get from using the ASSIGN command are either informational 
or error-related. All of the ASSIGN command messages are listed and 
described here alphabetically. 
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• Bad parameter. 

This message indicates an ASSIGN syntax error; your input is invalid. 


• Device MTpdn Assigned. 

This is an informatioral message letting you know that your tape drive 
has been assigned. (Notice that the physical device number is the one 
given in this message.) 


• Device not assigned. MTn 

This error message indicates that the device you specified has not yet 
been assigned. 


• Magtape assignment request aborted (asnmt$) 

ER! 

This is an error message indicating that the operator cannot handle 
your assignment request. 


• No Magtape assignment permitted. (asnmt$) 

ER! 

This error message indicates that the operator is not permitting any 
magnetic tape assignments at this time. 


• The device is in use. (asnmt$) 

ER! 

This error message indicates that another user has the specified device 
assigned. 


• Use of 'MIX' argument not permitted at system console. (asnmt$) 
ER! 

The MTX argument requires a response from the system terminal. 
Moreover, work cannot be done at the user terminal until the response 
is received. For these reasons, a user at the syston terminal is not 
allowed to send himself an ASSIGN request involving the MTX argument. 


118.4 

119.0 


118.4 
119.0 
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THE UNASSIGN COMMA ND 

The UNASSIGN command unconditionally unassigns your peripheral device, 
which in this case is a magnetic tape drive. This command unassigns 
only the specified tape drive that you previously assigned with the 
ASSIGN command. When you complete a magnetic tape operation, it is 
good practice to release the tape drive for general use as soon as 
possible. 

The command line format for UNASSIGN is as follows: 

UNASSIGN | WTpdn ) [-UNLOAD] 

\ -ALIAS MTldn I 

If you specify the —ALIAS option, MTn is the logical device number 
(Mn). in this case you are unassigning the tape drive by the ldti. if 
you do not specify the —ALIAS option, MTn is the physical device number 
(gdn). You are then unassigning the tape drive by the pdn . 

The -UNLOAD option allows the tap® to be rewound and then placed 
off-line (unloaded). This option is not available on all drives or 
controllers. Check with your System Administrator or operator to see 
if you may use -UNLOAD at your installation. 

A tape drive can only be unassigned by: 

• The user who assigned it. 

• The system operator. 

The system operator can unassign any drive using the px3n argument. The 
"-ALIAS ldn" option can be used only if the drive is owned by (i.e., 
was previously assigned by) the operator. 

If an operator unassigns your tape drive, no message will appear at 
your terminal. Should you subsequently attempt to unassign the same 
device, an error message will be displayed. 

For example, suppose that you assign the following tape drives: 

OK, ASSIGN MTl -ALIAS MT2 
Device MTl assigned. 

OK, ASSIGN MTX -ALIAS OTTO 
Device MT0 assigned. 

OK, 

You can unassign physical drive MTl as follows: 

OK, UNASSIGN MTl 
or 

OK, UNASSIGN -ALIAS MT2 
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If the command is successful, the message, "Device released" is 
printed. You can unassign physical drive MTO as follows: 

OK, UNASSIGN -ALIAS WTO 

or 

OK, UNASSIGN MTO 

Hie operator must unassign these drives by their physical device 
numbers: 

OK, UNASSIGN MT1 
or 

OK, UNASSIGN MTO 


UNASSIGN Command Messages 

Messages you get from using the UNASSIGN command are either 
informational or error-related. All UNASSIGN command messages are 
listed and described here alphabetically. 


• Bad parameter. 

Hiis message indicates an UNASSIGN syntax error; your input is 
invalid. 

• Device not assigned. MTn 

This error message indicates that the device you are attanpting to 
unassign has not yet been assigned. 


• Device released. 

This is solely an informational message telling you that the device you 
unassigned is released. 


118.4 
119.0 
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Operator 
Control of 
Tape Drives 


INTRODUCTION TO THE COMMANDS 

The system operator uses the commands ASSIGN, UNASSIGN, and STATUS 
DEVICE just as any user, though sometimes with certain modifications. 
(See Chapter 4 for descriptions of these three commands.) In addition, 
there are two commands to control tape drive operations that are used 
solely by the system operator. These are SEIMOD and REPLY. They allow 
the operator to: 

• Set various modes of tape operation 

• Reply to user tape mount requests 


THE SETMOD COMMAND 

The SETMOD command allows the operator to establish the mode of tape 
drive assignment. There are three modes of tape drive assignment: 

• User (Default) mode : The operator is permitting users to assign 
their own tape drives (with the ASSIGN command). The operator 
intervenes only if special assistance is requested. 

• Operator mode : Users must channel all tape drive assignment 
requests through the operator. All assignment requests appear 
at the operator's console, and the operator must respond to 
them. (See Hffi REPLY COMMAND later in this chapter.) 
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• No assignment mode : Users are not permitted to assign tape 
drives at all. in this mode, a user assignment request produces 
an ASSIGN command message saying that tape drives cannot be 
assigned. 

The command line format for SEMOD is as follows: 


SETMOD 


-USER 

-OPERATOR 

-NOASSIGN 


The -USER Option (Default Mode) 

The -USER option specifies the default assignment mode. It allows 
users to assign tape drives by physical device number (pdn), with or 
without the "-ALIAS ldn" option. All other options require operator 
intervention. 


The -OPERATOR Option (Operator Mode) 

The -OPERATOR option gives the operator full control of all tape drive 
assignments. In this mode, all user-issued ASSIGN commands and their 
corresponding user numbers are displayed at the operator's console. 
The operator answers each assignment request (see the REPLY command) 
with a message sent to the user terminal. 


The -NOASSIGN Option (No Assignment Mode) 

The -NOASSIGN option forbids tape drive assignment. Also, in this 
mode, no operator is available to assist with tape assignments or 
mounts. This mode of operation may be used to indicate temporary 
absence of the operator in an environment where the operator has total 
control over tape drive assignment. 


Console Messages 

Messages displayed at the operator's console, then, depend on the 
current assignment mode established by the SETMDD command. The message 
is sent to the operator by the ASSIGN subsysten and either requests the 
operator to assign a tape drive or mount a tape on a drive. This 
message repeats periodically until the operator responds with the REPLY 
command. The format of the message that appears is as follows: 

***** MAGTAPE REQUEST ***** 

From usrnam (usrnum): message 
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usrnam The name of the user requesting the tape assignment 
usrnum The user number 

message The same as the command line which the user typed, less 
the command word ASSIGN 

The following example illustrates default mode assignment (either 
SETMOD -USER has been specified or the SETMOD command has not been used 
at all). Assume that user number 6, with user name ADLEY, types the 
following command line: 

OK, ASSIGN MT2 -TPID SUEA -6250 
OK, 

The operator sees the following on the system terminal: 

***** MAGTAPE REQUEST ***** 

From ADLEY (6) : MT2 -TPID SUEA -6250 


SETMOD Command Message 

There is only one message the operator may receive when attempting to 
use the SETMOD command: 

"occ..." not implemented or improper use of argument. (SETMOD) 

This is a syntax error message. All or part of the SETMOD command line 
is in an improper format. 


THE REPLY COMMAND 

The REPLY command establishes a link between the ASSIGN subsystem and 
the operator. It is the operator's method of communicating with each 
user terminal. REPLY allows the operator to: 

• Inform a user that a special request has been fulfilled. 

• Deny a request. 

• Approve a simple request (in -OPERATOR mode). 

• Display the actual pdn assigned when MTX option is specified. 

• Request repetition of an ASSIGN message. 
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The command line format for REPLY is as follows 


RESEND 


REPLY -usrnum -TAPE ABORT 


GO 

pdn 


usrnum Identifies the user number. 

TAPE Indicates a reply to tape operation requests. 

RESEND Requests resending of ASSIGN'S message. 

ABORT Indicates that no tape drive is assignable, or the operator 
wants to abort the request for any reason (drive not 
available, tape not found, etc.) 

GO Identifies a reply to a tape mount request and assignment 
of a physical drive. It indicates that the requested tape 
has been mounted on the specified drive, or that the 
physical drive which the user picked is assigned and ready. 

pdn Identifies the physical drive number. This is a reply to 
the request of the assignment of a tape drive. It 
indicates that a drive has been assigned to the user, and 
the number of the assigned drive is pdn . This reply is 
used if the user specified MTX in the ASSIGN command. 

All outstanding (unanswered) requests may be repeated by using the -ALL 
option of REPLY. The operator can display just the most recent, or 
all, of the outstanding requests made by a specific user. The command 
line format is as follows: 



REPLY J-use mo 
|-ALL 


-userno is the number of the user whose requests the supervisor wants 
to see again. -ALL repeats all the outstanding requests issued by a 
specific user. -RESEND repeats only the last assignment request issued 
by a specific user. 

The operator may also set the message repetition frequency. The 
repetition period is the time between the printing of two successive 
messages from the same request on the operator's console. The command 
line format is as follows: 

REPLY -REPEAT seconds 

seconds is a decimal number specifying the message repeat period in 
seconds. The default message frequency is 3 minutes (180 seconds). 
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This example illustrates the operator reply to a simple assignment 
request. First, the user assigns a tape drive: 

OK, ASSIGN MTX -ALIAS MTO -TPID DATA -800 

OK, 

The operator then receives the following message: 

***** MAGTAPE REQUEST ***** 

From ADLEY (3) : MTX -ALIAS MTO -TPID DATA -800 

The operator mounts the tape DATA on an available drive and sets the 
density to 800 bpi. If, for instance, the operator chooses MT5 as the 
available drive, the reply would be: 

OK, REPLY -3 -TAPE 5 
OK, 


REPLY Command Messages 

The REPLY command generates both informational and error messages. All 
of these messages are listed and described here alphabetically. 


• "ccc..." not implemented or improper use of argument. (REPLY) 

This is a syntax error message. A string of characters in the command 
line is in an improper format. 


• No outstanding request from all users. 

This is an informational message telling the operator that there are no 
outstanding requests from any users. 


• No pending request from user n. 

This is an informational message telling the operator that there is no 
pending request from the specified user. 


• User number not specified. (REPLY) 

This is a REPLY error message. The operator did not give a user number 
in the command line. 
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Tapes 


INTRODUCTION 

The PRIMOS LABEL command is used to initialize magnetic tapes. LABEL 
writes either IBM (nine-track EBCDIC or seven-track BCD) or ANSI 
(nine-track ASCII) Level 1 volume labels followed by dumny HDR1 and 
EDF1 labels. LABEL can also be used to read existing VOLl and HDR1 
labels. ANSI labels are written in accordance with the ANSI standard 
X3.27-1978. IBM labels are written in accordance with IBM's 
specifications (IBM manual GC28-6680-5). Any nonstandard labels such 
as seven-track ASCII or user-defined labels cannot be read or written. 


USING LABEL 

The command line format for LABEL is as follows: 


LABEL MTn [-TYPE type] 
[-ACCESS access] 


-VOLSER 

-VOLID 

-VOLUME 


volume-id] 


[-OWNER owner] 
[-INIT] 
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The meanings of the parameters are: 


MTn The tape drive where the tape to be labelled is located. 

n is a number between 0 and 7. This keyword is required 
and must be the first on the command line. 

type -TYPE A nine-track ASCII (ANSI) 

(this is the default) 

-TYPE B seven-track BCD (IBM) 

-TYPE E nine-track EBCDIC (IBM) 

volume-id A one- to six-character string that uniquely identifies 
this tape reel. If you specify fewer than six 

characters, they are blank-padded on the right. The 

keywords -VOLUME, -VOL, or -VOLSER may be substituted 
for the keyword -VOLID. 


owner One to 14 characters long for ANSI labels, one to 10 
characters long for IBM labels. If you specify fewer 
than 14 (or 10) characters, they are blank-padded on the 
right. If this keyword is omitted, the default is the 
user's login name. The keyword -OWN may be substituted 
for the keyword -OWNER. 

access A single character defining access to this tape. ACCESS 
is not used by Prime software but is included for 
completeness. If it is omitted, it is left blank on 
ANSI labels. ACCESS is ignored for IBM labels. 

-INIT Necessary keyword for tapes previously unformatted. 


To read existing labels, type the command: 


LABEL Mm [-TYPE type] 

To write labels, type the command: 

LABEL MTn [-TYPE type] -VOLID volume-id [-OWNER owner] 

[-ACCESS access] [-INIT] 

The following example illustrates how you would use LABEL to write an 
ANSI VOLl label on a new tape located on logical device number 3. The 
owner of the tape is SPARIS, the volume serial ID is SP573, and the 
access is set to X: 

OK, LABEL MT3 -TYPE A -VOLSER SP573 -OWNER SPARIS -ACCESS X 
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The next example illustrates the command line to read seven-track IBM 
labels that already exist on the tape (located on logical device number 
6 ): 

OK, LABEL MT6 -TYPE B 


LABEL Command Errors 

Improper use of the LABEL command causes an error message to be 
printed. These errors are the result of bad syntax in the LABEL 
command itself or a PRIMOS magnetic tape I/O error. 


.itax Errors: All LABEL command syntax errors are listed and 
‘scribed here alphabetically. 


• ***ACCESS IGNORED FOR IBM LABELS (WARNING ONLY) 

This is a warning only — processing continues. (Error 13) 

• ***DUPLICATE KEYWORD DETECTED 

The same keyword was typed more than once. (Error 1) 

• ***INVALID LABEL TYPE SPECIFIED 

Label type must be one of the characters A, E, or B. (Error 5) 


• ***INVALID TAPE UNIT SPECIFIED 

Something other than MT0-MT7 was typed. (Error 2) 


• ***LABEL operation aborted 

Error 9, 10, 12, or 14 occurred and the label was not read. (Error 11) 


• ***label read was not TYPE X 

The label read was not of the type specified. (Error 12) 
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• ***N0 MAGNETIC TAPE UNIT SPECIFIED 

A magnetic tape unit is required. (Error 6) 

• ***CWNER ID SPECIFIED IS TOO DONG 

The owner ID cannot be longer than 14 characters. (Error 4) 

• ***CWNER ID SPECIFIED IS TOO LONG FOR TYPES B OR E 

CErroTIo ^ f0r ™ labels cannot be longer than 10 characters. 

• ***UNABLE TO READ TAPE LABEL CN THIS TAPE 

A mag tape read error occurred and the label was not read. (Error 10) 

• ***UNABLE TO WRITE TAPE LABEL CN THIS TAPE 

^Error^r err ° r occurred the label m not written. 

• ***UNRE00GNIZED KEYWORD, String (CMDL$A) 

An invalid keyword (string) appeared on the command line. (Error 15) 

• ***VQL1 LABEL ALREADY EXISTS 

ANSI standards prohibit the rewriting of VCL1 labels. (Error 14) 
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• ***VQLUME ID SPECIFIED IS TOO LONG 

The volume ID cannot be longer than six characters. (Error 3) 

• ***VOLUME ID WAS NOT SPECIFIED 

When writing labels, a volume ID is required. (Error 7) 

PRIMOS Errors: The PRIMOS magnetic tape I/O errors are listed and 
described here alphabetically. 

• subr BADC 

LABEL improperly called magnetic tape subroutines. 

• subr EOF 

Indicates end of file on the magnetic tape. 

• subr EOT 
Indicates end of tape. 

• subr HERR 

Tape drive hardware error. 

• subr MTNO 

The tape drive is not operational. 

• subr PERR 

Parity error on the tape drive. 
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• MTn NOT ASSIGNED 

Use command AS MTn before the LABEL command. 


(In the above errors, subr is the name of the mag tape subroutine that 
reported the error. See The ERIMOS Subroutines Reference Guide for 
more information regarding these errors.) 

if LABE L successfully writes a label, the message TAPE LABEL WAS 
WRITTEN SUCCESSFULLY is displayed. On read operations, LABEL prints 
out the volume and owner IDs, creation date, access (ANSI tapes only), 
and other information. 
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The MAGNET 
Subsystem 


INTRODUCTION TO MAGNET 

To transfer data by magnetic tape from a non—Prime operating system to 
PRIMUS and vice versa , you must write the magnetic tape in an 
interchange format that both operating systems can understand. MAGNET 
is the PRIMUS subsystem that allows you to read and write magnetic 
tapes in these various interchange formats. MAGNET is intended 
primarily for users who have had prior experience with magnetic tapes. 

Some of the facilities that the MAGNET subsystem provides are: 

• Declaration and modification of I/O objects 

• Linkage of I/O objects with PRIMUS global variables 

• Translation to and from various character sets 

• User-definable character sets 

• Seven-track binary packing and unpacking 

• Tape positioning 

• Physical tape copying 

• Logical data transfer between devices with support of multiple 
destinations 
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18.4 

19.0 


18.4 

19.0 


Support of unlabelled tapes and of MSI and IBM standard 
labelled tapes 



• Support of fixed-length records and of IBM, MSI, and Prime 
variable-length records 

• Support of old (pre-rev 18.4) MAGNET features for the READ, 
WRITE, COPY, and POSITION subcommands 


• Support for tape operations within Batch mode 
intervention) 


(operator 


• Tape-to-spooler and disk-to-spooler support 

• Break key handling 


USING MAGNET 

The basic steps in using MAGNET are as follows: 

1. ASSIGN your tape drive(s). 

2. Invoke MAGNET. 

3. Define your source and target objects. You are allowed one 
source object, one or many target objects for each task. 
Source objects may be either tape or disk files. Target 
objects may be tape, disk, or spool files. 

Because specification of tape formats can be lengthy, MAGNET 
allows you to store descriptions as global variables. It also 
allows you to define one object as being "LIKE" another. In 
addition, the new format of MAGNET makes it easy to write and 
store entire MAGNET sessions as CPL programs or OOMINPUT files. 

4. Request the action you want MAGNET to perform: for example, 
READ, WRITE, COPY, MOVE. 

5. When the work is done, QUIT from MAGNET and UNASSIGN the tape 
drive(s). 

A sample MAGNET session, showing the actions taken within MAGNET, is 
provided at the end of this chapter. 
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INVOKING MAGNET 

To invoke MAGNET, you must be at PRIMUS command level. The format is: 

MAGNET [-SILENT] -USER 

-OPERATOR 

-SILENT causes only MAGNET severity 2 or 3 errors to be printed at your 
terminal. -USER or -OPERATOR (-OPR) directs the printing of MOUNT and 
DISMOUNT messages to your terminal or the operator's terminal, 
respectively. For detailed information on these options, see Appendix 

B. 

After you type MAGNET and possibly a mode option, the subsystem prints 
a release number and gives you a prompt. For example: 

OK, MAGNET 
[MAGNET, Rev. 18.4] 

> 

After the MAGNET prompt (>), you type a subcommand line that contains 
one or more of the 18 MAGNET subcommands. Depending on the subcommand, 
the line may also contain one or more object-names and/or one or more 
options. The MAGNET subcommand line format is as follows: 

> subcommand obj ect-name (s) option= (value),...option= (value) 

There are a few points to remember when typing subcommand lines: 

• Input can be up to 1000 characters long. 

• You can use either upper- or lowercase alpha characters or a 
combination of both. 

• Free format is allowed on the subcommand line. (Spacing is 
optional.) 


MAGNET SUBCOMMANDS 

There are 18 subcommands in MAGNET. Fourteen of these are the basic 
MAGNET subcommands, which define, manipulate, and transfer data within 
the subsystem. These subcommands are described in the beginning of 
this chapter. The five other subcommands are used less frequently and 
are described later in this chapter under ADVANCED MAGNET . Table 7-1 
lists each MAGNET subcommand, its type, and its function. 
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Table 7-1 
MAGNET Subcommands 


Subcommand 

Type 

Function 

/* 

— 

Puts comments in your MAGNET 
dialog. 

CLOSE 

Data Definition/ 
Manipulation 

Closes a disk, tape or 
spool file 

COPY 

Data Transferral 

Copies one or more physical 
files from one tape to another. 

DECLARE 

Data Definition/ 
Manipulation 

Associates one or more options 
with an object-name. 

DELETE 

Data Definition/ 
Manipulation 

Deletes one or more declared 
object-names. 

DISPLAY 

Data Definition/ 
Manipulation 

Shows all options associated 
with a declared object-name. 

LIST 

Data Definition/ 
Manipulation 

Lists all declared 
object-names. 

LOAD 

Data Definition/ 
Manipulation 

Loads a translation table. 

MODIFY 

Data Definition/ 
Manipulation 

Changes an option value or 
adds an option to an 
object-name. 

MOVE 

Data Transferral 

Moves a logical file from 
a source object to one or 
more destination objects. 


First Edition, Update 1 


7-4 







THE MAGNET SUBSYSTEM 


Table 7-1 (continued) 
MAGNET Subcommands 


Subcommand 

Type 

Function 

NOISY 

— 

Allows printing of severity 

1 messages. 

POSITION 

Data Transferral 

Positions a tape to a 
specific file number and 
record number. 

QUIT 

— 

Exits from MAGNET and returns 
you to PRIMUS command level. 

READ 

Data Transferral 

Reads a file from a tape and 
transfers it to a disk file. 

RENAME 

Data Definition/ 
Manipulation 

Renames declared 
object-names. 

SAVE 

Data Definition/ 
Manipulation 

Saves options associated 
with an object-name in a 

PRIMUS global variable. 

SILENT 


Disallows printing of 
severity 1 messages. 

TRANSLATE 

Data Definition/ 
Manipulation 

Specifies the translation 
associated with an 
object-name. 

WRITE 

Data Transferral 

Writes a disk file onto 
tape. 
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CftTA DEFINITION AND MANIPULATION SUBCOMMAN DS 

There are ten MAGNET subcommands that define and manipulate data within 
the subsystem. They are DECLARE, LIST, DISPLAY, RENAME, MDDIFY, 
DELETE, and TRANSLATE. 

Seven of these subcommands, DECLARE, LIST, DISPLAY, MODIFY, RENAME, 
DELETE, and TRANSLATE are described in the following paragraphs. The 
other 3 data definition and manipulation subcommands are described 
later in this chapter under ADVANC ED MAGNET. 


18.4 
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The DECLARE Subcommand 

You use DECLARE to define and characterize a given object, 
subcommand line format is as follows: 


The 


> DECLARE object-name< 


SFOCL=(filename) 
TAPE=(devno) 

DIS K= (pa thname) 
EXTERNAL=(gvar) 
k LIKE=(obj ect-name) 


[,OFTION=(value)...] 


The object name identifies either a tape file, disk file, or spool 
file. You always specify an object-name with the DECT,ARE subcommand. 
It is good practice to create object-names that are mnemonic. You can 
use any combination of up to 32 alphabetic characters, numerals, and 
the two characters period (.) and underscore (_). Any of these 
characters may appear first in the object-name. You may declare up to 
100 object-names. 

An OPTION provides information that describes an object-name. The 
first option you specify on the DECLARE subcommand line must always be 
TAPE, DISK, SPOOL, LIKE, or EXTERNAL. Other options, if any, follow. 
Table 7—2 lists each MAGNET subcommand option, its type, applicable 
subcommand(s), and its function. 

There are 42 possible options you can specify with the DECLARE 
subcommand. Twenty-two of these are the basic options that you use for 
most tape operations in MAGNET. These are described here. The other 
20 are options you may use less frequently. These are described later 
m this chapter under ADVANCED MAGNET. 
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Table 7-2 

MAGNET Subcommand Options 


Option 

Type 

Applicable 
Subcommand(s) 

Function 

ACCESS 

Tape 

DECLARE, MODIFY 

Identifies the ACCESS 
field on HDRl, EOF1, and 

EOV1 (level 1) labels. 

AMOUNT 

— 

COPY 

Specifies the number 
of files to copy. 

AT 

Spool 

DECLARE, MODIFY 

Specifies location at 
which to print a 
spool file. 

BFACTOR 

Tape 

DECLARE, M3DIFY 

Specifies the number of 
logical records per 
physical tape block. 

BUFFERS 

Tape 

DECLARE, MODIFY 

Specifies the number of 
buffers being used. 

BYPASS 

Tape 

DECLARE, MDDIFY 

Indicates to MAGNET 
whether or not to 
ignore tape labels 
and identify its files 
by number. 

CHARACTERS 

Tape 

DECLARE, MODIFY 

Specifies whether one or 
two characters per word 
are to be read or 
written. 

CONTROL 

Spool 

DECLARE, MODIFY 

Specifies the type of 
line-printer carriage 
control desired. 

COPIES 

Spool 

DECLARE, MODIFY 

Specifies the number 
of copies to be printed 
on a line-printer. 

CREATE 

Tape 

DECLARE, MODIFY 

Identifies the creation 
date field for Level 1 
file labels. 

DEFER 

Spool 

DECLARE, MDDIFY 

Specifies the time a 
spool file is to be 
printed. 
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Table 7-2 (continued) 
MAGNET Subcommand Options 


Option 

Type 

Applicable 
Subcommand(s) 

Function 

DENSITY 

Tape 

DECLARE, MODIFY 

Specifies density of 
the tape being read or 
written. 

DISK 

Disk 

DECLARE, MODIFY, 

Specifies the location of 



LOAD 

a disk file. 

EXCHANGE 

Tape 

DECLARE, MODIFY 

Indicates whether, for 
each logical record, high 
and low order bytes within 
words are to be exchanged. 

EXPIRE 

Tape 

DECLARE, MODIFY 

Identifies the expiration 
date field for Level 

1 file labels. 

EXTERNAL 


DECLARE, MODIFY, 
SAVE 

Indicates that additional 
options can be found in 
an external PRIMOS global 
variable. 

FILEID 

Tape 

DECLARE, MODIFY 

Identifies the labelled 
file to be read or written. 

FILENO 

Tape 

DECLARE, MODIFY 

Specifies a file number. 

FORM 

Spool 

DECLARE, MODIFY 

Specifies the type of 
line-printer forms 
to be used for 
printing. 

FORMAT 

Disk 

Tape 

Spool 

DECLARE, MODIFY 

Identifies the type of 
records being read or 
written. 

GENERATION 

Tape 

DECLARE, MODIFY 

Identifies the generation 
field of Level 1 file 
labels. 

ITEMS 


LIST 

Specifies what type 
of objects should 
be listed. 
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Table 7-2 (continued) 
MAGNET Subcommand Options 


Option 

Type 

Applicable 
Subcommand(s) 

Function 

LABELS 

Tape 

DECLARE, MODIFY 

Identifies the type of 

labels on a tape. 

LEVEL 

Tape 

DECLARE, MODIFY 

Specifies the amount of 
labelling on a tape. 

LIKE 


DECLARE, MODIFY 

Identifies another 
object-name whose 
options, option values, 
and translation edit 
tokens are to be 
duplicated. 

LINENOS 

Spool 

DECLARE, MODIFY 

Specifies whether 
line numbers should be 
printed on line-printer 
output. 

LINES 


LOAD 

Specifies the number of 
lines in a user 
translation table. 

LRECL 

Disk 

Tape 

Spool 

DECLARE, MODIFY 

Specifies the number of 
bytes in each logical 
record. 

MAXIO 

Tape 

DECLARE, MODIFY 

Limits the maximum I/O 
transfer size. 

MODE 


POSITION 

Instructs MAGNET to 
position either absolutely 
or relatively. 

NEXTCHAIN 

Disk 

Tape 

Spool 

DECLARE, MODIFY 

Declares the next object 
in a chain of 
objects. 
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Table 7-2 (continued) 
MAGNET Subcommand Options 


Option 

Type 

Applicable 
Subcommand(s) 

Function 

OFFSET 

Tape 

DECLARE, MODIFY 

Specifies the size of 
a field, at the beginning 
of physical records, 
that contains 
control characters 
to be ignored. 

OWNER 

Tape 

DECLARE, MODIFY 

Identifies the owner id 
field on a VCLl label. 

PAD 

Tape 

DECLARE,MODIFY 

Specifies a padding 
character. 

PARITY 

Tape 

DECLARE, MODIFY 

Identifies the parity of 
a seven-track tape. 

POSTACTION 

Disk 

Tape 

Spool 

DECLARE, MODIFY 

Specifies action to 
perform when closing a 
tape, disk, or 
spool file. 

PREACTION 

Disk 

Tape 

spool 

DECLARE, MODIFY 

Specifies action to 
perform when opening 
a tape, disk, 
or spool file. 

PREVCHAIN 

Disk 

Tape 

Spool 

DECLARE, MODIFY 

Declares the previous 
object in a chain of 
objects. 

PRINT 


OOPY 

Prints the size of the 
first physical record in 
each tape file. 

PROTECT 

Tape 

DECLARE, MODIFY 

Prevents writing on a tape. 

RECORDNO 

Tape 

DECLARE, MODIFY 

Specifies the number of 
physical records to be 
spaced forward or backward. 

SEQUENCE 

Tape 

DECLARE, MODIFY 

Identifies the file 
sequence field on 

Level 1 file labels. 
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Table 7-2 (continued) 
MAGNET Subcommand Options 


Option 

Type 

Applicable 
Subcommand(s) 

Function 

SPOOL 

Spool 

DECLARE, MDDIFY 

Defines a spool file. 

TAPE 

Tape 

DECLARE, MDDIFY 

Defines a tape object. 

TRACKS 

Tape 

DECLARE, MDDIFY 

Specifies the number of 
tracks on a tape. 

TYPE 


LOAD 

Identifies the type of 
a translation table. 

VERSION 

Tape 

DECLARE, MDDIFY 

Identifies the generation 
version field on Level 1 
file labels. 

VISUAL 

Tape 

DECLARE, MDDIFY 

Identifies the external 
visual id of a tape reel. 

VCLSER 

Tape 

DECLARE, MDDIFY 

Identifies the volume 
serial id field on a 

VCLl label. 
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18.4 

19.0 


The TAPE Option : You specify the TAPE option if the object-name 
preceding it on the subcommand line refers to a tape file. The value 
you assign to this option is the logical device number of the tape 
drive on which the tape is mounted (a number from 0 to 7). You must 
assign your tape drives at PRIMDS command level before you invoke 
MAGNET. For more information, see the ASSIGN command in Part II, 
PRIMDS MAGNETIC TAPE COMMANDS. In the following example, the DECLARE 
subcommand defines the object-name TFILE to be a tape file. It is 
located on logical device (tape drive) number 7. 

> DECLARE TFILE TAPE=(7) 

> 


The DISK Option ; You specify the DISK option if the object-name 
preceding it on the subcommand line refers to a disk file. Hie value 
you assign to this option must be a PRIMDS filename or pathname. In 
the following example, the object-name DFILE is a PRIMDS disk file, 
SOCSECNUMS, in the UFD SFA: 

> DECLARE DFILE DISK=(SFA>SOCSECNUMS) 

> 


The SPOOL Option : You specify the SPOOL option jf the object-name 
preceding it on the subcommand line refers to a spool file. The value 
you assign to this option must be an alphanumeric string of no more 
than 32 characters length. The value of the spool option is printed as 
a banner on your spooler output. In the following example, the 
object-name PRODUCES is a spool file. The option value, AUTOS, will 
appear as the banner on the line-printer output: 

> DECLARE PRODUCTS SPOOL=(AUTOS) 

> 


The LRECL and BFACTOR Options : LRECL is the logical record length 
option. It specifies tEe number of bytes in each logical record in 
fixed-length format, or the maximum number of bytes in each logical 
record in variable-length format. 

BFACTOR is the blocking factor option. It specifies the number of 
logical records per physical tape block. For more information on 
logical record sizes and blocking factors, see the discussion on 
RECORDS, GAPS, AND BLOCKS in Part I, INTRODUCTION TO MAGNETIC TAPES. 
The relationships between logical records, blocking factors, and 
physical tape blocks are illustrated in Figures 7-1, (A) through (D). 

LRECL and BFACTOR together specify the maximum size of a tape file's 
physical records. You obtain this maximum size by multiplying the 
value of LRECL by the value of BFACTOR. The maximum size can be no 
larger than 12,288 bytes (this number is smaller if you are using ANSI 
or IBM variable-length records). BFACTOR is strictly a tape option; 
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you use it only with tape objects. LRECL is for both tape and disk 
jects. You must always specify the value of LRECL for tape files 
If you do not specify BFACTOR, it defaults to the value of 1. ^ 

KxwS'ff 1 specifies the size in characters of each record 
in an 5 Sctt df^k fIf ° r Ina 1 xiinurn size in characters of each record 
12 288 f Va } Ue mUSt be an even nuinber between 2 and 

SUEFILP LS f° llowi ng example, you declare X to be a disk file, 
SUEFILE. Each logical record m the disk file is 80 characters long: 

> DECLARE X DISK=(*>SUEFILE), LRECL=(801 


Note 

diSk file ' Y ° U mUSt alSO ^cify P0RMAT= (FIXED) . 
ror ASCII flies, you should specify F0 RMAT=(VAR/prime). For 

i^thichapter nf 366 ^ discussion of the FORMAT option later 

Si'S!** e ^P le ' tiie tape file EMINAMES has a blocking factor of 10 
logical records per physical record. Each logical record contains a 

SO^bytes^ 8 ° byteS * Therefore ' the maximum physical record size is 


> DECLARE 

> 


EMFNAMES TAPE=(3), LRECL=(80), BFACT OR=(10) 


T he TRACKS Option; You specify the TRACKS option to identify the 
number of tracks on your tape. The two possible values are either 7 or 
9, for seven or nine-track tapes respectively. TRACKS is strictly a 
t^e option, and it defaults to the value of 9. In the following 

SSSJ'4, iTnJZt' “™“ s ' is a nine - track lc - ted « 


> 

> 


DECLARE EMPNAMES TAPE= (6) , TRACKS=(9) 


SfDENSITY Option: You use DENSITY to specify the density of the tape 
that you are reading or writing. For seven-track tapis, you 2S 
pecify either 200, 556, or 800 (bpi) as the value. For nine-track 

DENSITY^?*? ^ s f ci£ y either 800, 1600, or 6250 (bpi) as the value. 
ENSITY is solely a tape option, and it defaults to the value of 800. 
In the following example, DATAFILE is a tape object located on loqical 
device number 2. It is a seven-track tape with a density of 556 9 bpi. 


> DECLARE DATAFILE TAPE=(2), TRACKS=(7), DENSITY=(556) 
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The LRECL and BFACTOR Options 

(A) Fixed-length Records, Blocking Factor — 1 

(B) Fixed-length Records, Blocking Factor = N 

Figure 7-1 
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Block Block Block 




File Marker 



Beginning and/or End of Tape Marker 



Inter-Record Gap 


The LRECL and BFACTOR Options 

(C) Variable-length Records, Blocking Factor = 1 

(D) Variable-length Records, Blocking Factor = N 

Figure 7-1 
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The FORMAT Option : You use the FORMAT option to identify the type of 
records you are reading from or writing to your tape, disk or spool 
file. There are four possible values you can specify for tape objects: 

• FIXED (for fixed-length records) 

• VAR/ANSI (for ANSI standard variable-length records, nine-track 
only) 

• VAR/IBM (for IBM standard variable-length records, nine-track 
only) 

• VAR/PRIME (for Prime variable-length records) 

18.41 There are three possible values you can specify for disk or spool 
19.01 objects: 

• FIXED (for fixed-length records, binary files) 

• VAR/PRIME (for Prime variable-length records, ASCII files) 

^*q| • UNCOMPRESSED (for uncompressed, fixed-length disk files only) 

With Prime variable-length records, the logical record length equals 
the physical record length; you can specify any size up to a maximum 
of 12,288 bytes. For tape objects it is important to note that you 
must always specify a value of 1 for the BFACTOR option for this format 
only. Prime variable-length tape records have no record control word 
(RCW) or block control word (BCW). (For more information on the Prime 
variable-length tape format, see Part I, Chapter 2.) These formats are 
illustrated in Figures 7-2, (A) through (C). 

The UNCOMPRESSED option is for writing to disk files only and is 
similar to FIXED format except that new-line characters are written at 
the end of every record. As in FIXED format, no blanks are compressed. 
UNCOMPRESSED format is the default format used when pre-rev. 18.4 READ 
subcommands are issued and partial translation is specified for EBCDIC 
or BCD files. Uncompressed files are read the same way as VAR/PRIME 
disk files. 

18.41 For tape objects, FORMAT defaults to FIXED for a value. For disk and 

19.01 spool objects, FORMAT defaults to VAR/PRIME for a value. In the 

following example, CANDY is a tape object located on logical device 
number 5. It is a nine-track tape with fixed-length records, each of 
which may attain a maximum 100 characters: 

> DECLARE CANDY TAPE=(5), TRACKS=(9), PORMAT=(FIXED) , LRECL=(100) 

> 


18.4 

19.0 




# 
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In the following example, X is a spool object with banner SUEFILE. It 
is a Prime variable - length file with records that may attain a maximum 
of 80 characters : 

> DECLARE X SPOCL=(SUEFI LE), LRECL=(80), PORMAT=(VAR/PRIME) 

> 


Note 

With disk or spool files you must also specify a logical record 
length. For more information, see the discussion of the LRECL 
option in this chapter. 


The PARITY Option: PARITY specifies either odd or even parity for a 
seven-track tape. It is a seven-track tape option only; nine—track 
tapes are always written in odd parity. There is no default for this 
option. You must always specify it when you declare a seven-track tape 
object. In the following example, STATS is a tape object located on 
logical device number 2. It is a seven—track tape with odd parity: 

> DECLARE STATS TAPE=(2), TRACKS=(7), PARITY=(ODD) 

> 


The PROTECT Option: This option is the software equivalent of a 
write-enable ring - on a reel of magnetic tape. PROTECT prevents you 
from writing on your tape. You specify either YES or NO as the yalue. 
If you do not specify PROTECT, it defaults to NO. This option is for 
tape objects only. In the following example, VITAL_INPO is a tape 
object located on logical device 0. It is protected from writing: 

> DECLARE VITAL_INFO TAPE=(0), PROTECT=(YES) 

> 


The LABELS Option: You use the LABELS option to identify the type of 
tape labels tEatfyou are using. There are three possible values you 
can specify: 

• NONE (You are not using any type of labels.) 

• ANSI (You are using ANSI standard labels.) 

• IBM (You are using IBM standard labels.) 
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The FORMAT Option 

(A) Fixed-Length Format 
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Figure 7-2 


First Edition, Update 1 


7-18 























THE MAGNET SUBSYSTEM 


LABELS is strictly a tape option. If you do not specify it, it 
defaults to NONE. In the following example, INCOME is a tape obgect 
located on logical device number 6. It is a nine-track tape with ANSI 
standard labels written at 800 fcpi: 

> DECLARE INCOME TAPE=(6), LABELS=(ANSI), TRACKS=(9), DENSI TY=(80 0) 

> 


The LEVEL Option: You use the LEVEL option to identify the number of 
labels present"on your tape. LEVEL limits the number of labels written 
on output; it has no effect whatsoever on input. There are four 
possible values that you can specify: 

• 0 (for an unlabelled tape) 

• 1 (for Level 1 labels only: HDRl, EOFl, or BOVl) 

• 2 (for Level 1 labels and HDR2, EOF2, and/or EOV2 labels only) 

• 3 (for Level 1 labels, HDR2, EOF2, EOV2, and user labels only) 

These four levels are illustrated in Figures 7-3, (A) through (D). For 
more information on these levels of tape labels, see Part I, Chapter 3 
of this manual. 


Note 

Prime does not yet support user label processing. You may 
specify a value of 3 f but MAGNET treats it as if you had 
specified a value of 2. 


LEVEL is for tape objects only. If you do not specify it, the default 
is 0. In the following example, MYTAPE is a tape object located on 
logical device number 3. It has two levels of IBM standard labels: 

> DECLARE MYTAPE TAPE=(3), LABELS=(IBM), LEVEL=(2) 

> 
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Beginning and/or End of Tape Marker 



Inter-Record Gap 


The LEVEL Option 
(A) Tape Format for LEVEL = (0) 

Figure 7-3 
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The LEVEL Option 
(B) Tape Format for LEVEL = (1) 

Figure 7-3 
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The LEVEL Option 
(C) Tape Format for LEVEL = (2) 
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The LEVEL Option 
(D) Tape Format for LEVEL = (3) 

Figure 7-3 
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The FILEID O ption; You use the FILEID option to identify the name of 
tne labelled file you wish to read or write. FILEID specifies the 
fil^id field of Level 1 labels. The value you specify for this option 
is a string of no more than 17 characters. If you specify fewer than 
17 characters, the value is blank-padded on the right. The string can 
be any mixture of the following: 

• URper and/or lowercase alpha characters 

• Numbers 

• Any other characters except right and left parentheses, equal 
signs, commas, apostrophes, and blanks 

FILEID is solely a tape option. If you do not specify it, the default 
is 17 blanks. In the following example, SYSIN is an IBM standard 
labelled file located on logical device number 2. The file-id field of 
the Level 1 labels is SOCSECNUMS: 

> DECLARE SYSIN TAPE=(2), LABELS=(IBM), FILEID=(SOCSECNU MS) 


The FILENO Option : FILENO identifies the number of the file you wish 
to work with on your tape. It is strictly a tape option for unlabelled 
files or for labelled files whose labels are being bypassed. (For more 
information, see the description of the BYPASS option.) Alternatively, 
you use the FILENO option with POSITION, a MAGNET subcommand, to 
specify absolute or relative file positioning on,a tape. (For more 
information, see the POSITION subcommand description later in this 
chapter.) 

If you use this option to specify an unlabelled tape file or a labelled 
file whose labels are bypassed, the value must be a number greater than 
or equal to 0. (A value of 0 indicates that you wish to work with the 
file at your current position on the tape.) If you use FILENO for 
positioning, the value may be less than 0. 

In the following example, CUTFILE is an unlabelled tape object located 
on logical device number 1. You are working with the second file on 
the tape: 

> DECLARE CUTFILE TAPE=(1), LABELS=(NONE), FILENO=(2) 


The CWNER Option : You use the OWNER option to identify the owner 
identificaton field on a VCLl label. The value you specify depends on 
whether your tape is ANSI or IBM labelled. For both types of labelled 
tapes, the value is a string of characters. You can specify up to 14 
characters for ANSI labelled tapes and up to 10 characters for IBM 
labelled tapes. If you specify a value that contains less than the 
maximum number of characters for either format, the value is 
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blank-padded on the right. As for the FILEID option, the string can be 
any mixture of the following: 

• Upper and/or lowercase alpha characters 

• Numbers 

• Any other characters except right and left parentheses, equal 
signs, commas, apostrophes, and blanks 

OWNER is strictly a tape option. If you do not specify this option for 
an ANSI labelled tape object, it defaults to 14 blank characters. The 
default for an IBM labelled tape object is 10 blank characters. In the 
following example, WAGES is an ANSI labelled tape object located on 
logical device number 4. The owner identification field is SUSANADLEY: 

> DECLARE WAGES TAPE=(4), LABELS=(ANSI), QWNERf (SUSANADLEY) 

> 


The VGLSER Option: VOLSER identifies the volume serial identificaton 
field (VQLSER number) on a VQLl label. The value is a string of no 
more than six characters that can be a mixture of any of the following: 

• Upper and/or lowercase alpha characters 

• Numbers 

• Any other characters except right and left parentheses, equal 
signs, commas, apostrophes, and blanks 

If you specify less than six characters, the value is blank-padded on 
the right. The VQLSER option is solely for tape objects. If you do 
not specify it, the default is six blank characters. In the following 
example, DATA_TEST is an ANSI labelled tape object located on logical 
device number 3. The VCLSER id is 63A: 

> DECLARE DATA_TEST TAPE=(3), LABELS=(ANSI), VCLSER=(63A) 

> 


The RECORIM) Option: The RECORIM) option identifies the number of 
physical reoorcli that you wish to space either forward or backward. 
You use this option only in conjunction with the POSITION and COPY 
subcommands. (For more information, see the descriptions of the 
POSITION and COPY subcommands later in this chapter.) The value you 
specify with RECORIM) is either a positive or negative number (for 
spacing either forward or backward, respectively). This option is for 
tape objects only. If you do not specify it, the default is 0. In the 
following example, BAR is a tajpe object located on logical device 0. 
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RECORDNO indicates to the POSITION subcommand that you wish to position 
the tape five filanarkers backward and then 17 physical recor<fe 
forward: 

> DECLARE BAR TAPE=(0) , FILENO=(-5), REG0RDN0=(17) 

> 


The VISUAL Option : You use VISUAL to specify the external visual 
identification of the tape reel you are using. The external visual 
identification is located on the tape reel enclosure, and its position 
is illustrated in Figure 7-4. VISUAL simplifies the identification of 
tape reels for MOUNT and DISMOUNT requests. The value is a string of 
eight characters that can be any combination of the following: 

• Upper and/or lowercase alphabetic characters 

• Numbers 

• Any other characters except right and left parentheses, equal 
signs, commas, apostrophes, and blanks 

VISUAL is solely for tape objects. If you do not specify it, the 
| default is 8 blank characters. In the following example, STEVE is a 
tape object located on logical device number 7. The external visual 
identification of this tape reel is MYTAPE2: 

> DECLARE STEVE TAPE=(7), VISUAL=(MYTAPE2) 

> 


The BYPASS Option : With BYPASS, you indicate to MAGNET whether or not 
to ignore the labels on your tape and then identify the tape files by 
number as opposed to file-ids. The value you specify is either YES or 
NO. There are a few important points to keep in mind when you use this 
option: 

• BYPASS is valid only when you are reading a tape. 

• You must always specify, with the LABELS option, the type of 
labels to be bypassed (either ANSI or IBM). 

• BYPASS causes MAGNET to ignore all associated label options 
(VCLSER, OWNER, FILEID). 

This option is for tape objects only. If you do not specify it, the 
default is NO. In the following example, FILE2 is an ANSI labelled 
tape object located on logical device number 6. You indicate that you 
want MAGNET to ignore all the labels and then position at the second 
logical file on the tape: 

> DECLARE FILE2 TAPE=(6), LABELS=(ANSI), BYPASS=(YES), FILENO=(2) 

> 
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The BUFFERS Option : All magnetic tape I/O is performed through 
internal buffers. Each tape object must have its own I/O buffers in 
order to use the READ, WRITE, or MOVE subcommands. You specify the 
BUFFERS option to indicate how many internal buffers are being used for 
magnetic tape I/O. The value is a numeral, which may be 0 through 10 
only. If you specify BUFFERS with a DECLARE subcommand and then later 
modify it with a lesser value, the extra buffers are released (returned 
to the free storage list). 


The BUFFERS option is for tape objects only and it defaults to a value 
of 0. In the following example, you declare a tape object, DOT. It is 
located on logical device number 2 and has 3 internal I/O buffers: 


> DECLARE DOT TAPE=(2), BUFFERS=(3) 

> 


Note 



To use a specific tape object with the READ, WRITE, or MOVE 
data transferral subcommands, you must always specify the 
BUFFERS option with a value greater than 0. (These subcommands 
are described in detail later in this chapter.) 


18.4 

19.0 


18.4 

19.0 


The AT Option : The AT option specifies the location at which to print 
a spool file. It is strictly a spool option whose value is a string of 
32 characters that can be any combination of the following: 

• Upper and/or lowercase alphabetic characters 

• Numbers 

• Any other characters except right and left parentheses, equal 
signs, commas, apostrophes, and blanks 

In the following example, the object-name GRQSS_PAY, a spool object, 
will be printed at a location called BOSTON: 

> DECLARE GRQSS_PAY SP0CL=(EMPLOYEES), AT= (BOSTON) 


The COPIES Option : The COPIES option specifies the number of copies of 
your spool file you would like printed. The value is a number from 1 
to 32767. Hie default number of copies printed is 1. This option is 
provided for spool objects only. An example, in which 23 copies of the 
spool object GROSS_PAY (from the previous exmple) are desired is: 

> DECLARE GRQSS_PAY SPOCL=(EMPLOYEES), COPIES=(23) 
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The FORM Option: The FORM option specifies the type of line-printer 
forms you would like your spool file printed on. The value of this 
option is a string of no more than 6 characters that can be a 
combination of any of the following: 

• Upper and/or lowercase alphabetic characters 

• Numbers 

18.4 

• Any other characters except right and left parentheses, equal 19.0 
signs, commas, apostrophes, and blanks 


The FORM option is provided for spool objects only and defaults to a 
value of 6 blank characters. In the following example, a spool object 
named TOTALS is declared with the AT, COPIES and FORM options: 


> DECLARE TOTALS SP00L=(RECEIPTS), 00PIES=(12), 

FORM=(3PART),AT=(FRAMINGHAM) 


The LIST Subcommand 

You use LIST to see what object-names you have declared. The 
subcommand line format is as follows: 

(DISK) 

(TAPE) 

> LIST [ ITEMS = (SPOOL) ] 

(OPEN) 

(CLOSED) 

MAGNET prints out a chart that shows all declared object-names and the 
type of the object (DISK, TAPE or SPOOL). In the following example, 

LIST shows the three declared objects TFILE, DFILE, and SFILE to be 18.4 
tape, disk, and spool objects, respectively. 19.0 


> LIST 

obj ect-names 

type 

open status 

TFILE 


Tape 

Closed 

DFILE 


Disk 

Closed 

SFILE 


Spool 

Closed 


> 
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18.4 

19.0 


The ITEMS Option : The ITEMS option is used to limit the output from 
the LIST subcommand. You can direct LIST to display all tape objects, 
disk objects or all spool objects previously declared. In addition, 
you can direct LIST to print only those objects that are not currently 
in use (CLOSED) or which are in use (OPEN). An object may have been 
left in use if, for example, you hit the BREAK key while a data 
transferral operation was underway. Using the previous LIST example, 
you could request that only spool objects be displayed: 


> LIST ITEMS=(SPOOL ) 

object-names 

SFILE 

> 


type 

Spool 


open status 
Closed 


The DISPLAY Subcommand 


DISPLAY shows all options associated with a declared object-name, 
subcommand line format is as follows: 


The 


18.4 

19.0 


18.4 

19.0 


> DISPLAY object-name 

The subcommand output shows all possible options that you can specify 
for an object-nam e. Tape options appear for tape objects, disk options 
appear for disk objects, and spool options appear for spool objects. 
Those options that you previously declared for the specified 
object-name appear with their values, along with those that 
automatically default, if you do not specify them. The following is an 
example of DISPLAY output for a tape object, SYSIN. You first declare 
SYSIN with four options and their values. The LIST subcommand confirms 
that SYSIN is a declared tape object. Output from DISPLAY then shows 
all possible options for SYSIN, but only shows the values for those you 
declared (TAPE, FILENO, LABELS, and BYPASS) and those you did not 
declare that default automatically. 


> LIST 




obj ect-names 

tape open status 


SYSIN 

TAPE Closed 



> DISPLAY SYSIN 




*** Information for TAPE object SYSIN *** 



PREV= 

/ NEXT= 



PREACTION 

POSTACTION 

= 


TAPE = 3 

TRACKS 

= 9 


DENSITY =800 

CHARACTERS 

= 2 


LABELS = ANSI 

LEVEL 

= 

0 

BYPASS = YES 

PROTECT 

= NO 


FORMAT = FIXED 

PARITY 

= 


LRECL = 0 

BFACTOR 


1 

OFFSET = 0 

BUFFERS 

= 

0 
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MAXIO 

= 10000 


VISUAL 

FILENO 

= 

5 

RECORDNO 

EXCHANGE 

= NONE 


FILEID 

VCLSER 

= 


OWNER 

GENERATION 

= 0001 


VERSION 

CREATE 

= 00000 


EXPIRE 

ACCESS 

= 


SEQUENCE 

PAD 

= , 040'0 



TRANSLATE 

> 

= (A*) 





= 00 

= 00000 

= 1 .18.4 

<19.0 


The next example shows DISPLAY output for a disk object, SYSCUT. You 
declare SYSCUT with only one option, DISK. The LIST subcommand 
confirms that SYSCUT is a disk object. Output from the DISPLAY 
subcommand shows all possible disk options for SYSCUT, but only prints 
values for DISK, LRECL, and FORMAT. (The values shown for LRECL and 
FORMAT are default values.) 


> DECLARE SYSCUT DISK=(SUE>SOURCE>REV19>FILE2) 

> LIST 

object-names type open status 


SYSCUT DISK Closed 

> DISPLAY SYSCUT 

*** Information for DISK object SYSCUT *** 

DISK = SUE>SCURCE>REV19>FILE2 

PREV= / NEXT= 

PREACTION = POSTACTION = 

LRECL = 0 FORMAT = VAR/PRIME 

> 


18.4 

19.0 


The next example shows DISPLAY output for a spool object, BCNUSES. You 
declare BCNUSES with only one option, SPOOL. The LIST subcommand 
confirms that BCNUSES is a spool object. Output from the DISPLAY 
subcommand shows all possible spool options for BCNUSES. Note that 
only the SPOOL, AT and COPIES options have received values. Other 
options, such as FORMAT and LRECL received default values. 


> DECLARE BONUSES SPOCL=(BCME_OFFICE), AT=(BOSTON), CPPIES=(12) 

> LIST 

object-names type open status 


BCNUSES 


Spool Closed 


> DISPLAY BCNUSES 

*** Information for SPOOL object BCNUSES *** 


SPOOL = HOME OFFICES 


PREV= 

PREACTION 

LRECL 

AT 

COPIES 

FORM 


= 0 

= BOSTON 
= 12 


/ NEXT= 
POSTACTION 
FORMAT 
CONTROL 
DEFER 
LINENOS 


= VAR/PRIME 
= NONE 

= NO 
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18.4 

19.0 


18.4 * * 
19.0» 


18.4 | 
19.0' 


The RENAME Subcommand 

You use RENAME to change the name of a declared object. The subcommand 
line format is as follows: 

> RENAME old-object-name new-object-name 

In the following example, EMPNOS1 is a previously declared object, as 
shown in the LIST subcommand output. You rename EMPN0S1 to EMPN0S2, 
and the new-obj ect-name appears when you give a second LIST subcommand. 


> LIST 



object-names 

type 

open status 

EMPN0S1 
> RENAME 

EMPN0S1 EMPNOS2 

TAPE 

Closed 

> LIST 

object-names 

type 

open status 

EMPNOS2 


TAPE 

Closed 


> 


The MODIFY Subcommand 

MODIFY changes a declared object or option. For example, you can add 

an option to an object-name or change the value of an option. The 

subcommand line format is as follows: 

> MODIFY object-name OPTION=(value) [,OPTION=(value)...] 

On the subcommand line, options can be in any order; you do not have 
to specify DISK, TAPE, SPOOL, LIKE, or EXTERNAL as the first option. 
All options that you can use with the DECLARE subcommand are also valid 
for MODIFY. There are four important points to remember when you use 
the MODIFY subcommand: 

• You can only modify object-names already declared. 

• You can only specify tape options for a tape object. 

• You can only specify disk options for a disk object. 

• You can only specify spool options for a spool object. 

In the following example, you declare a tape object, BETA_TEST. You 
specify the options TAPE, TRACKS, FORMAT, DENSITY, and FILENO with 
their corresponding values. A LIST subcommand confirms that BETA_TEST 
is a declared tape object. The output from a DISPLAY subcommand shows 
the declared options and values for BETA_TEST. You now wish to modify 
BETA_TEST by adding seme options to those you have already declared. 
With the MODIFY subcommand, you specify the additional options LABELS, 
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LRECL, BFACTOR, and BYPASS. Again, a LIST subcommand confirms that 
BETA_TEST is a tape object. Now, when you give the DISPLAY subcommand, 
the output shows not only the options and corresponding values you 
specified when you first declared BETA_TEST, but also those you 
specified when you modified it. In both cases with the DISPLAY output, 
you also see the options that default automatically, if you do not 
specify them. 

> DECLARE BETA_TEST TAPE=(0), TRACK S=(9), FORMATS (VAR/ANSI), 

DENSITY^(6250), FILENO=(2) 

> LIST 


object-names 

type 

BETA_TEST 

TAPE 

> DISPLAY BETA_TEST 


*** Information for TAPE 

Object BETA TEST *** 

PREV= 

/ NEXT= 


PREACTION 

TAPE = 0 

DENSITY = 6250 

LABELS = NONE 

BYPASS = NO 

FORMAT = VAR/ANSI 

LRECL = 0 

OFFSET = 0 

MAXIO = 10000 

FILENO = 2 

ENHANCE = NONE 

VQLSER 

GENERATION = 0001 

CREATE = 00000 

ACCESS 

PAD = '040'O 

TRANSLATE = (A*) 

> MODIFY BETA TEST LABELS= (ANSI), 

POSTACTION 

TRACKS = 9 

CHARACTERS = 2 

LEVEL = 0 

PROTECT = NO 

PARITY 

BFACTOR = 1 

BUFFERS = 0 

VISUAL 

REOORDNO = 0 

FILEID 

OWNER = 

VERSION = 00 

EXPIRE = 00000 

SEQUENCE = 0 

LRECL=(100) f BFACTOR=(10), 

BYPASS=(YES) 





> LIST 





object-names 

type 



BETA_TEST 


TAPE 



> DISPLAY BETA_TEST 




*** Information for TAPE object BETA_TEST *** 



PREV= 


/ NEXT= 



PREACTION 

= 

POSTACTION 

= 


TAPE 

= 0 

TRACKS 

= 9 


DENSITY 

= 6250 

CHARACTERS 

= 2 


LABELS 

= ANSI 

LEVEL 

= 

0 

BYPASS 

= YES 

PROTECT 

= NO 


FORMAT 

= VAR/ANSI 

PARITY 

= 


LRECL 

= 100 

BFACTOR 

= 

10 

OFFSET 

= 0 

BUFFERS 

= 

0 

MAXIO 

= 10000 

VISUAL 

= 


FILENO 

= 2 

REOORDNO 

= 

c 


,18.4 
• 19.0 


7-33 


First Edition, Update 1 


















UFD5027-184 


18.4 

19.0 


18.4 

19.0 


EXCHANGE 

= NONE 

VQLSER 

= 

GENERATION 

= 0001 

CREATE 

= 00000 

ACCESS 

= 

PAD 

= '040'0 

TRANSLATE 

= (A*) 

> 



FILEID 

OWNER 

VERSION = 00 

EXPIRE = 00000 

SEQUENCE = 0 


The DELETE Subcommand 

This subcommand deletes one declared object-name. When you delete an 
object-name, you also clear the space it occupied internally within 
MAGNET. The subcommand line format is as follows: 

> DELETE object-name 

In the following example, output from a LIST subcommand shows that you 
have two previously declared tape objects, STATS1 and STA3S2. You 
delete STATS2, and a second LIST subcommand reflects the deletion. 


> LIST 

obj ect-names 

type 

open status 

STAISl 

TAPE 

Closed 

STATS2 

TAPE 

Closed 

> DELETE STATS 2 



> LIST 



object-names 

type 

open status 

STATS1 

TAPE 

Closed 


> 


The TRANSLATE Subcommand 

TRANSLATE indicates, for tape objects only, that you want particular 
logical records translated to or from industry standard ASCII, EBCDIC, 
or BCD. Translation is also available for several different 
seven-track binary formats. For example, suppose you have an 
80-character logical record. The first 40 characters specify a 
person's name in EBCDIC and the last 40 characters specify binary 
information. You could specify a translation for the first 40 
characters to Prime ASCII and the second 40 characters could be read as 
they are. The subcommand line format for TRANSLATE is as follows: 

> TRANSLATE object-name ([repetition factor] edit token list) 
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An edit token specifies how you want particular fields of a logical 
record translated. An edit token is an alpha character optionally 
followed by any of the following: 

• Upper and/or lowercase alpha characters 

• Numbers 

• An asterisk 

• Any other characters except right and left parentheses, equal 
signs, commas, apostrophes, and blanks 

An edit token list is a group of edit tokens separated by commas. Each 
edit token or edit token list may be preceded by an optional repetition 
factor, which is always a number. An example of an edit token is A6, 
which specifies a translation of six characters to industry standard 
ASCII. Table 7-3 lists each translation edit token and its function. 
Facilities are available for inserting fill characters, specifying no 
translation (reading or writing raw data), and for utilizing 
user-defined translation tables. (For detailed information on all edit 
tokens and translation character set tables, see Appendix A. For 
detailed information on modifying user-defined translation tables, see 
the description of the LOAD subcommand later in this chapter.) 

In the following example of the TRANSLATE subcommand, you are reading 
from a tape. You first specify a translation of six characters from 
industry standard ASCII to Prime ASCII, (P6). You next specify a 
translation, for 40 pairs of fields, of six characters frcm industry 
standard ASCII to Prime ASCII, (P6,40(P6)). You next indicate that you 
want to delete the next two characters in the field (P6,40(P6,D2)). 
Lastly, any characters that ronain in the logical record are translated 
frcm industry standard ASCII to Prime ASCII (P6,40(P6,D2),P*) . 

> TRANSLATE BETA_TEST (P6,40(P6,D2),P*) 

> 

If you wish to change a translation, you do it by simply giving another 
TRANSLATE command line. For example, to change the translation of 
BETA_TEST shown above, you might type the following: 

> TRANSLATE BETA_TEST (B4,30(B7,D3),B*) 

> 

Remember that you can always check on the translation you specified 
when you give the DISPLAY command. 
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Table 7-3 

Translation Edit Tokens 


Edit Token 

Function 

A 

Enforces industry standard ASCII. 

B 

Translates Prime ASCII to and 
from BCD code. 

C 

Moves the column position within 
fields of logical records. 

D 

Deletes characters in logical 
records. 

E 

Translates Prime ASCII to and 
from EBCDIC code. 

F 

Specifies fill characters. 

G 

Specifies seven-track packing 
code 2424 (see Appendix A). 

H 

Specifies seven-track packing 
code 4242 (see Appendix A). 

I 

Specifies seven-track packing 
code 2466 (see Appendix A). 

J 

Specifies seven-track packing 
code 4266 (see Appendix A). 

K 

Specifies seven-track packing 
code 6246 (see Appendix A). 

L 

Specifies seven-track packing 
code 6426 (see Appendix A). 

M 

Specifies seven-track packing 
code 6624 (see Appendix A). 

N 

Specifies seven-track packing 
code 6642 (see Appendix A). 

0 

Specifies no translation. 

P 

Enforces Prime ASCII. 

Q through U 

Reserved for future use. 

V through Z 

Specify user codes. 
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EftTA TRANSFERRAL SUBCOMMANDS 

There are four MAGNET subcommands that transfer data within the 
subsystem. They are READ, WRITE, MOVE, and COPY. READ, WRITE, and 
MOVE are logical copy operations. COPY is a physical tape copy 
operation. 


The READ Subcommand 

You use the READ subcommand to move information in a tape file (source 
object) to a disk file (destination object). The tape and disk files 
must be previously declared object-names. (The pre-Rev 18.4 
functionality of READ is still supported. See Appendix C.) The 
subcommand line format for READ is as follows: 

> READ tape-object-name disk-object-name 

In the following example, you first declare a tape object, SYSIN, which 
is located on logical device 0. You specify the third file on the 
tape, which has five records per physical tape block with each record 
100 characters long. By default you are working with fixed—length 
records. There are no tape labels. Within the MODIFY subcommand you 
use another option, BUFFERS, to specify that three internal buffers are 
being used by the tape object, SYSIN. To perform a READ operation, 
your BUFFERS value for the tape object must be greater than or equal to 
1. Next you declare a disk object, SYSQJT, which is a disk file, 
DIMPLE, in the UFD SFA. Finally, your READ subcommand line causes the 
information in SYSIN to be read into SYSOJT. 

> DECLARE SYSI N TAPE=(0), FILENO =( 3), LRECL=(100), BFACTOR=(5) 

> modieTs ys in BUFFERS=(3) 

> DECT .ARE SYSOUT DISK=(SFA>DIMPLE) , LRECL=(100) 

> READ SYSIN SYSOUT 

> 


The WRITE Subcommand 

The function of the WRITE subcommand is the opposite of READ. You use 
WRITE to move information in a disk file (source object) to a tape file 
(destination object). As with the READ subcommand, the disk and tape 
files must be previously declared object-names. To perform a WRITE 
operation, the value you specify with the BUFFERS option for a tape 
object must be greater than or equal to 1. (The pre-Rev 18.4 
functionality of WRITE is still supported. See Appendix C.) The 
subcommand line format for WRITE is as follows: 

> WRITE disk-object-name tape-object-name 
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In the following example, you are working with the same two previously 
declared objects, SYSIN and SYSCUT. However, you wish to move the 
information in SYSCUT into SYSIN: 

> WRITE SYSCUT SYSIN 

> 


The MOVE Subcommand 


You use this subcommand to simultaneously move information in a source 
object into a maximum of seven destination objects. Source and 
18.4 destination objects must be previously declared and may be either disk, 
19.0| tape, or spool objects. To perform a MOVE operation, the value you 
specify for the BUFFERS option for a tape object must be greater than 
or equal to 1 for each tape object you use. The subcommand line format 
for MOVE is as follows: 


> MOVE source-object-name destination-object-name(s) 

In the following example, you first declare your source object, 
NEJV_DATA, to be a disk file. You next declare the first of your four 
intended destination objects, PLACEl. This is a tape file with 
characteristics as shown. You then declare your next three destination 
objects, PLACE2 (a tape file), PLACE3 (a tape file), and PLACE4 (a disk 
^il®)• These files have the characteristics shown. The output from a 
LIST subcommand shows the objects you have just declared. Finally, you 
use the MOVE subcommand to simultaneously move the information in 
NEWJQATA to PLACEl, PLACE2, PLACE3, and PLACE4. 


18.4 

19.0 


> DECLARE NEW_DATA DISK=(SFA>STATS), LRECL=(80) 

> DECLARE PLACEl TAPE=(0), LRBCL=(100), BFACT QR=(10) . BUFFERS=(3) 

PORMAT=(VAR/ANSI), FILENQ=(10) ~ --- 

> DECLARE PLACE2 TAPE=(1), LRECL=(80), BFACTQ R=(201. BUFFERS=(6) 

> MODIFY PLACE2 FORMAT= (VAR/IBM), FILENO=(l) 

> DECLARE PLACE3 TAPE=(5), LRECL=(150), BFACTOR=( l), BUFFERS=(9), 

LABELS= (ANSI), LEVEL=(2), VQLSERf(597219), 0WNER= (PARIS)~, FILEID= 

( SRCPkGI ) 

> DECLARE PLACE4 DISK=(PARIS>S0URCE>PR0GRAM.FTN), LRECL=(80) 

> LIST ——--- —l 


obj ect-names 

type 

open status 

NEW_DATA 

PLACEl 

PLACE2 

PLACE3 

PLACE4 

> MOVE NEW_DATA PLACEl 

DISK 

TAPE 

TAPE 

TAPE 

DISK 

PLACE2 PLACE3 

Closed 

Closed 

Closed 

Closed 

Closed 

PLACE 4 


r 
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The source object specified with a MOVE subcommand may be either a tape 
or disk object. The destination object(s) specified may be either 
tape, disk, or spool objects. 


The COPY Subcommand 

You use the COPY subcommand to copy information from a source tape to 
one or more destination tapes. This is a physical, as opposed to a 
logical, copy function. (The pre—Rev 18.4 functionality of OOPY is 
still supported. See Appendix C.) 


Note 

Your tape will be positioned before it is copied. You indicate 
the starting position on the tape by use of the FILENO and 
RECORDNO options with the DECLARE and MODIFY subcommands. 
(These two options are discussed earlier in this chapter.) The 
FILENO/RECORDNO pair must be an absolute position; the values 
for both options must be greater than or equal to 0. If they 
are equal to 0, none of the tapes are pre-positioned. (For 
more information on tape positioning, see The POSITION 
Subcommand, later in this chapter.) 


The format of the COPY subcommand line is as follows: 


XX)PY source destination(s) AMOUNT = • 


(n) ) 

f ' 

(YES) 

/ , PRINT = - 


1 

(NO) 


You may specify up to eight obiect—names in the subcommand. line (one 
sour ce-obj ect-name and from one to seven destination—object —names). 
The - tape objects - must be previously declared and must refer to 
different tape drives. You must always specify the AMOUNT option in 
the OOPY subcommand line. 


The AMOUNT Option: The AMOUNT option identifies the number of physical 
tape files to be copied. (Copying is done from one file marker to 
another file marker.) There is no default for AMOUNT. You must 
specify this option on the COPY subcommand line. 


Note 


Since the COPY subcommand performs a physical tape copy as 
opposed to a logical tape copy, tape labels are not recognized. 


18.4 

19.0 
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are tw0 . P° ssible values you can specify for the AMOUNT option 

SSSftaTK"* 1 2 1 " i n) - r 91 asterisk <*)• nuS”l OP ^ 

identifies the number of physical files that are to be copied. The 
value can be a number between 1 and 32,767. If you wish P to copy 

Swcv?\ ln9 S n * Y ° Ur untl1 you reach the first filemarker after the 

STii 1 r? nd Z? f " t S e - {E0T) ' you specify 311 asterisk (*) for a 
value, if the physical EOT (end of tape) is detected, and if you did 

not specify AMOUNT (*), and then a single file marker is read, Swing 

fSgJJJ? * n f W u SOUrCe -J ape is ^aested. (See Appendix B for more 
information.) Likewise, if the physical EDT is detected on a 

destination tape, a single file marker is written and a new tape is 
requested. (See Appendix B.) ™ 


The miNT Option: The PRINT option specifies that the size, in words, 

t-fr^?n i fir ^ P^ 1031 record of each tape file is printed on your 

^ re /5 e v f lues you 0311 specify for this option, either 
YES or NO. The default value is NO. 

If you specify PRINT=(YES), a table like the following is printed as 
the copy operation proceeds: r 


File # Words Read 


1 

2 

3 


200 

350 

790 


Total Blocks Read 

250 

97 

1123 


When MAGNET has completed copying a file, the total number of physical 
records in that file is also displayed in the third column of the 
table. The PRINT option replaces the "PRINT RECORD SIZES?" question 

information R ^ V MAGNET dialog. (See Appendix c for additional 

2j® • eX3IT,ple illustrates the use of the COPY subcommand and 

the AMOUNT option. You first declare a tape object, SYSIN, that is 
logical device 0. The FILENO/REGORDNO option pair instructs 
mGNET to rewind the tape and then position it to file number 1, record 
number 1. You then declare SYSCUT, a tape object located on logical 
device number 1, and SYSCUT2, a tape object located on logical device 
number 2. With SYSCUT and SYSCUT2, the FILENO/REGORDNO option pair 
functions the same way as in the SYSIN declaration. You then qi v r a 

? )P Lo!im 0rnin ! nd line which °°P ies all of SYSIN, the source-object-name, 
S ^ v f d SYSCUT2, the two destination-object-names. Remember that 
ail of SYSIN is copied because you specified an asterisk (*) as the 
value for the AMOUNT option. 
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> DECLARE SYSIN TAPE= (0) . FI LENO= (1) , RE00REN 0= (1) 

> DECLARE SYSOUT TAPE= (1) , FIL E N0=(1) , REX30RDN0= _(lj 

> DECLARE SYSCUT2 TAPE =(2) . FILENO= (1) , RE00REN0 =J1) 

> COPY S YSIN SYSO UT SYS0UT2 AM 3JN T=(*), PRINT= (NO) 

> 


ADDITIONAL SU BCOMMANDS 


The POSITION Subcommand 


The POSITION subcommand positions a tape to a specific FILENO/RECORENO 
pair. Positioning can be either absolute (rewind the tape first then 
space forward) or relative (space forward or backward frcm your current 
position on the tape). Before tape positioning, both the FILENO and 
RECORDNO options must be set by the DECLARE or MODIFY subcommands. For 
absolute positioning, the values for both the FILENO and RECORDNO 
options must be greater than or equal to 1. For relative positioning 
the two options can have any values. (The pre-Rev 18.3 functionality 
of POSITION is still supported. See Appendix C.) The subcommand line 
format for POSITION is as follows: 


> POSITION object-name MDDE= 


(ABS) 

(REL) 


18.4 

19.0 


The object-name is the name of the tape you wish to position and must 
always be a previously declared tape object. You must always specify 
the type of positioning (absolute or relative) with the MODE option. 


The MODE Option: You use the MODE option to specify_either absolute or 
j-gPative tape positioning on a POSITION subcommand line. When you use 
|the POSITION subcommand, you must always specify either ABS or REL for 
the MODE option. 

The following example illustrates the use of both the POSITION 
subcommand and the MODE option. Assume that you have four physical 
files with six physical records in each of the files. You first 
declare Tl, a tape object located on logical device 0. You set the 
values of the FILENO and RECORDNO options to be 3 and 6, respectively. 

Next you give a POSITION subcommand that specifies absolute positioning 
for Tl. This instructs MAGNET to rewind the tape, space forward two 
file markers, and then space forward five records. 

|18.4 
119.0 


There are two ways to rewind your tape. In the following example, you 
rewind X by giving 1 as the value for both the FILENO and RECORIM) 
options and then specifying absolute positioning with the POSITION 


> DECLARE Tl TAPE=(0), FILENO=(3), REC0RDN0=(6) 

> POSITION Tl MQDE= (ABS) 

> 
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subcommand. You also rewind Y by giving very large, negative values 
for both FILENO and REOOEDNO and then specifying relative positioninq 
on the POSITON subcommand line. 

> DECLA RE X TAPE= (0) , FILENO (1), REOORDNO(l) 

> DECLA RE Y TAPE=(1) FILENO (-1000000) REODRDNO (-1000000) 

> POSITI ON X M0DE=(ABS) 

> POSITION Y MODE=(REL) 

> 


The QUIT Subc ommand 

You use QUIT when you wish to exit from MAGNET and return to PRIMOS. 
The subcommand line format is as follows: 

> QUIT 
OK, 


Note 

MAGNET ignores anything you type on the subcommand line that 
follows QUIT. 


The /* Subcommand 

You use this subcommand to put comments in your MAGNET dialog. It is 
the same as the PRIMOS comment command. Your comment can be up to 1000 
characters long. The subcommand line format is as follows: 

> /* ccccccccccccccccccc... 

> 


ADVANCED MAGNET 

There are advanced MAGNET features, subcommands, and options that you 
will use less frequently. These features supplement the basic MAGNET 
functions discussed up to this point in the chapter. 


Advanced Options 

lq’nl T * lere ar © 20 additional options that you can specify with the DECLARE 
• and MODIFY subcommands. 


18.4 

19.0 
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The EXTERNAL Option: When you use MAGNET, there may be specifi c se ts 
of options that you will want to use more than once. The EXTERNAL 
option allows you to save and reload these options so that you do not 
have to retype them each time. You can also use EXTERNAL with the SAVE 
subcommand. (See the description of SAVE later in this chapter.) 

Options are stored for later use in PRIMUS global variables. You can 
create these sets of options at PRIMUS level by using the PRIMUS 
command SET_VAR. To do this, your global variable file must be 
activated. The following example illustrates how you can set up groups 
of options at PRIMUS level by using SETVAR. 

OK, SET_VAR .SYSIN := TAPE=(0) , LRBCL=(80), EUFFERS=(2), FILENQ=(1) 
OK, 

For a description of PRIMUS global variable commands, refer to The CPL 
User's Guide. 

Ihe value you specify for the EXTERNAL option must be a valid PRIMUS 
global variable name. It is a string of no more than 32 characters. 
The first character in the string must always be a period (.). The 
other characters in the string can be any mixture of the following: 

• Upper and/or lowercase alpha characters 

• Numbers 

• Underscores 

• Periods 

With the DECLARE or MODIFY subcommands, you may specify EXTERNAL first 
in the option list on the subcommand line. However, no matter where 
EXTERNAL appears in the option list, MAGNET ignores any options that 
follow it. If you specify EXTERNAL as the first option with a DECLARE 
subcommand, the TAPE or DISK options must appear first within the CPL 
variable. 


Note 

When you give the DISPLAY subcommand, any edit tokens you 
specified with the TRANSLATE subcommand are shown in the 
output. These edit tokens are not regarded as options and thus 
cannot be saved or loaded by the EXTERNAL option. 
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There are a few points to remember when you use the EXTERNAL option: 

• A global variable cannot contain an EXTERNAL option. EXTERNAL 
can only appear within MAGNET. 

• Any options that appear within a global variable overwrite any 
of the same options already declared or modified. 

• Global variables cannot contain more than 1024 characters. 

• You may specify the same name for an EXTERNAL value and an 
object. 

In the following example, at PRIMOS command level, you first create a 
global variable file, IO.GVAR. A LESILVAR command shows that no global 
variables are defined. You then create two global variables for the 
file. These are .SYSIN and .SYSCUT. Output from a second LIST_VAR 
command shows that these two variables are now defined. Next, invoke 
MAGNET and declare two objects, SYSIN and SYSCUT. You specify the 
EXTERNAL option for each of these objects, the values being .SYSIN and 
.SYSCUT, respectively. This instructs MAGNET to get the global 
variables values in .SYSIN and .SYSCUT and put them into the internal 
variables SYSIN and SYSCUT. Next, you give the LIST subcommand, which 
confirms that SYSIN and SYSCUT are declared objects. Finally, the 
DISPLAY subcommand output for both SYSIN and SYSCUT shows all the 
values associated with variables SYSIN and SYSCUT. 

OK, DEFINEjGVAR IO.GVAR -CREATE 

OK, LISTVAR 

No global variables are defined. 

OK, SETVAR .SYSIN : = TA PE=(0) ,EUFFERS=(2) ,LRBCL=(80) ,FILENO=(l) 

OK, SET_VAR .SYSCUT := DISK=(TESTDIR>SFA>FILE3),LRECL=(80) 

OK, LISTVAR 

.SYSCUT DISK=(TESTDIR>SFA>FILE3),LRECL=(80) 

•SYSIN TAPE=(0),BUFFERS=(2),LRECL=(80),FILENO=(l) 

OK, MAGNET 

[MAGNET, Rev. 18.3] 

> DECLARE SYSIN EXTERNAL=(.SYSIN) 

> DECLARE SYSCUT EXTERNAL=(.SYSCUT) 

> LIST 

type open status 


TAPE Closed 

DISK Closed 


SYSIN *** 

/ NEXT= 

POST ACT ION = 

TRACKS = 9 

CHARACTERS = 2 

LEVEL = 0 

PROTECT = NO 

PARITY 


18.4 

19.0 


obj ect-names 


SYSIN 

SYSCUT 

> DISPLAY SYSIN 

*** Information for TAPE object 
PREV= 

PREACTION 

TAPE = 0 

DENSITY =800 

LABELS = NONE 

BYPASS = NO 

FORMAT = FIXED 


First Edition, Update 1 


7-44 


















THE MAGNET SUBSYSTEM 


LRECL 

OFFSET 

MAXIO 

FILENO 

EXCHANGE 

VOLSER 

GENERATION 

CREATE 

ACCESS 

PAD 

TRANSLATE 


= (A*) 


> DISPLAY SYSOUT 
*** Information for 


80 


BFACTOR 

0 


BUFFERS 

10000 


VISUAL 


1 

REGORDNO 

NONE 


FILEID 

OWNER 

0001 


VERSION 

00000 

, 040'0 


EXPIRE 

SEQUENCE 


DISK object SYSCUT *** 


DISK = TESTDIR>SFA>FILE3 
PREV= 


PREACTION 
LRECL 
> QUIT 
OK, 


80 


/ NEXT= 

POSTACT ION 
FORMAT 


1 

2 


0 


= 00 

= 00000 
= 0000 


= VAR/PRIME 


Q 


The LIKE Option: This option allows you to "copy" the option values 
and translation edit tokens of one object to another object. For 
example, if you are using a multi-reel labelled tape file, you must use 
two or more tape objects (depending on the number of tape reels) linked 
by the NEXTCHAIN option. (See the description of the NEXTCHAIN option 
below.) Chained, labelled tapes usually have many options in common, 
such as LABELS, LEVEL, FILEID, LP.E)CL, BFACTOR, FORMAT, CWNER, TRACKS, 
PROTECT, ACCESS, CREATE, or EXPIRE. Rather than retype these options 
and their values two or more times, use LIKE to "duplicate these 
options and option values. As an example, consider the following se 
of DECLARE and MODIFY statements: 

> DECLARE INFILE TAPE=(0), LRECL=(100), BFACTOR=(20) _, 

FORMAT=(VAR/ANSlj 

> MODIFY INFILE LABELS= (ANSI) , LEVEL=(2), ACCESS- (X) _, 

OWNER=(PAR IS) 

> MODIFY INFILE FILEID=(JANUARYPAY), VCLSER-(PRSALl), 

VISUAL= (0131811) _ 

F 1TOFY INFILE BUFFERS=(4), GENERATIDN=(0002), VERSION=(12) 

> MODIFY INFILE NEXTCHAIN= (INFILE2j~ 

> TRAN SLATE TNFTL E (A70.6(F*),3(A6,2(F))) 

> JS 

> DECLARE INFILE2 TAPE=(0), LRBCL=(100), BFACTOR=(20 ) ± 

FOR MAT=(VAR/ANSI) 

> MODIFY INFILE2 LABELS=(ANSI), LEVEL=(2), ACCESS-(X), 

OWNER=(PARIS) 

> MODIFY INFILE2 FILEID=(JANUARYPAY), VCLSER=(PRSAL2), 

VISUAL= (0131812) _..... 

> MODIFY INFTT.E9 BUFFERS=(4), GENERATION(0002), VERSION-(12) 

> TRANSLATE INFILE2 (A70,6 (F*) ,3 (A6,2 (F) )j~ 


,18.4 

>19.0 


18.4 

19.0 
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18.4 

19.0 


This sequence of statements can be shortened dramatically by typing: 

> DECLARE INFILE TAPE=(0), LRECL=(100), BFACTOR=(20}. 

F0RMAT= (VARZaNST) - -— U 

> MODIFY INFILE LA BELS^(ANSI), LEVEL=(2), ACCESS=(X). 

CWNER= (PAR IS) - 

> MODIFY INFI LE FILEID= (JANUARYPAY) , VQLSER= (PRRAT.l} . 

VISUAL= (01318lT) --— 

> MODIFY INFILE BU FFERS=(4}. GENERATION=(0002), VERSION=(12} 

> TRANSL ATE INFILE (A70,6(F*),T(A6^7FnT- 

> 7* 

> DECLARE INFILE2 LIKE=(INF ILE}. VISUAL=(0131812) 

> MODIFY I NFILE2 NE XTCHAIN=(I NFIL E2), VQLSERf(P RSAL2) 

All options, option values, and translation edit tokens associated with 
INFILE are duplicated in INFILE2. It should be remembered, however, 
that INF];LE2 is an object in its own right. If the BUFFERS option 
should be modified in INFILE, for example, the update is not reflected 
in INFILE2. Another MODIFY command would have to be issued to chanqe 
the BUFFERS value for INFILE2. Similarly, two DELETE commands are 
necessary to erase these objects and return their associated memory to 
the free memory pool. A LIST command will list two objects, not one, 

and two DISPLAY commands are necessary to view each object's option 
values. 


18.4, 

19.0' 


18.41 
19.01 


Ihe PREMg jON and POSTACTI O N Options : These options specify the action 
to be taken when opening and closing disk, tape, and spool files. You 
can, when opening, position to the end of the disk file so that new 
information read into it will be concatenated at the end. It is also 
possible to rewind a reel of tape before searching for and opening a 
f 1 1^* After a tape file has been closed, you may rewind and/or 
unload the tape reel. A spool file may or may not have a banner rage 
and may or may not require a page eject upon print completion. 


The PREACTION option has two possible values: APPEND, for disk 

18 • 4 RE ? IND ' for ob 3 ec ts and SUPRESS for spool objects. 

19.0 POSTACTION also has three possible values: REWIND and UNLOAD, both for 
ape objects only; and NO EJECT for spool objects only. Both PREACTION 
and POSTACTION default to six blanks. 


In the following example, you declare a disk object, SUEA, to be a disk 
file, SUEFILE. You specify the PREACTION option with an APPEND value 
This instructs MAGNET to position SUEFILE at its end upon opening. 

> DECLARE SUEA DISK= (SUEFILE) , PREACTION= (APPEND) 
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Note 

The FREACTION option with the APPEND value is useful only when 
you are reading into a disk file. 


In the following example, you declare a spool object, EXP, with banner 
ANIMALS, 12 copies and a print location of OZ. The PREACTION option 
specifies that the banner is not to be printed. 


> DECLARE EXP SPOOL= (ANIMALS) ,OOPIES= (12),AT=(OZ)_, 

PREACT ION=(SUPPRESS) 


18.4 

19.0 


In the next example, you declare a tape object, STEVEP, to be a tape 
file located on logical device number 7. Each logical record in the 
file is 80 characters long. You specify the PREACTION option with a 
REWIND value. Hiis instructs MAGNET to rewind the tape before opening 
file number 23. 


> DECLARE STEVEP TAPE=(7) , PREACTION= (REWIND) 

> MODIEY~~STEVEP LRECL=(80), FILENO=(23) 

> 


Note 

The PREACTION option with the REWIND value is useful only if 
your tape is positioned beyond a desired location. 


In the next example, you are working with the same tape object, STEVEP. 
However, you are now working with file number 42 on the tape, and you 
specify the POSTACTION option with a REWIND value. This instructs 
MAGNET to rewind the tape after closing tape file number 42: 

> DECLARE STEVEP TAPE=(7), FOSTACTION=(REWIND) 

> MODIFY STEVEP LRBCL=(80), FILENO=(42) 

> 

In this final example, you are again working with file number 42 in the 
tape object, STEVEP. You specify the POSTACTION option with an UNLOAD 
value. This instructs MAGNET to rewind and unload (dismount) the tape 
after closing tape file number 42: 

> DECLARE STEVEP TAPE=(7), FOSTACTION=(UNLOAD) 

> MODIFY STEVEP LRECL=(80), FILENO=(42) 

> 


The PREVCHAIN and NEXTCHAIN Options: It is possible to link together 
or "chain"' a number of tape, disk or spool objects. You would do this 
if, for example, you wanted to specify which tape should be mounted 
when you reach the end of the tape you are currently using. If you do 


118.4 
• 19.0 
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not specify chaining and the end-of-tape is detected, MAGNET requests 
that a new tape be mounted. However, since MAGNET does not initially 
recognize any characteristics of the new tape, it has no way of knowing 
it the new tape is the correct one. Consequently, this procedure is 
only useful for unlabelled tapes. 

If you are using labelled tapes and you expect to use a multi-reel 
file, you must specify chaining. When you declare your tape object, 
you specify data about the first reel of tape the file is on. You must 
also specify the NEXTCHAIN option on the DECLARE or MODIFY subcommand 
lines. The NEXTCHAIN option contains the name of another tape object 
When end-of-tape is detected, MAGNET rewinds the tape, looks up the 
information in the tape object specified by NEXTCHAIN, and requests 
that the new tape be mounted. 


18.4 

19.0 


When you specify a chain of tapes, you should include the BUFFERS 
option only for the first object in the chain. If you specify BUFFERS 
for any object after the first in the chain, those buffers are released 
when that tape object is activated. Other options that specify 
physical characteristics of the tape (such as TAPE, TRACKS, and 
DENSITY) or logical characteristics of the file (such as LRECL, 
BFACTOR,. FORMAT, and LABELS) should have the same value among all 
objects in the chain. In order to identify a new tape to be mounted, 
you should specify an external visual identification by using the 
VISUAL option. (For more information, see the description of the 
VISUAL option, earlier in this chapter.) 


The NEXTCHAIN option identifies the next object in a chain. PREVCHAIN 
identifies the previous object, but it is not currently used by MAGNET 
in this release. In addition, NEXTCHAIN is currently used only for 
tape objects. Values of both options are names of other tape, spool, 
or disk objects. A tape object cannot point to a non-tape object; the 
same restriction applies to disk and spool objects. Both options are 
for tape, spool and disk objects, and the defaults are blank 
characters. 


In the following example, you declare a tape object, TAXES, with a 
number of options. It is the first object in a chain, and the next 
object in the chain is 1AXES2. TAXES2 has exactly the same option 
values as TAXES except for OWNER, VGLSER, and VISUAL. Note that, since 
you did not specify NEXTCHAIN for TAXES2, it is the last object in the 
chain. When end-of-tape is detected on TAXES, the tape is rewound and 
a message appears on either your terminal or the operator's console 
(depending on whether you specify -USER or -OPERATOR at PRIMUS command 
level; see Appendix B). After the new tape specified fcy TAXES2 is 
mounted and either you or the operator replies to MAGNET'S message, 
processing continues with the object TAXES2. 


> DECLARE TAXES TAPE=(0), LRECL=(100), BFACTQR=( 20) 

> MODIFY TAXES DENSITY=(6250), FORMAT=(VAR /ANSI ) - 

> MODIFY TAXES LABELS= (ANSI), LEVEL=(2) 

> MODIFY TAXES FILEID=(1980), OWNER=(SIRAP ) 

> MODIFY TAXES VQLSER=(SFATAX), VISUAL=(X125) 
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> MODIFY TAXES BUFFERS =(7), MAXIO=(12000) 

> MODIFY TAXES NEXTCHAI N=(TAXE S2) 

> 7 * 

> DECLARE TAXES2 TAPE=(0) . LRECL=(100), BFACTOR-(_20 | 

> MODIFY TAXES2 DENSITY=(62 50) , FORMAT=(VAR/ANSI) 

> mDTFY^AXBTL^ELS=(MSiy , LEVEL= (2) 

> MODIFY TAXES2 FILEID=(1980 ), CWNER^NEVETS) 

> W~TAy?y:7~ VOT J SER= ( SFATX2) , VISUAL= (X126) 

> MODIFY"TAXES2 MAXIO= (12O00j~~ 

> 


The ACCESS Option: ACCESS identifies the accessibility of a tape 
object" Accessibility is installation-dependent. Prime software does 
not check the accessibility fields of the VCLl, HDRl, EOF1, and BOVl 
labels. Consequently, this option is provided for tape protection 
purposes on other systems. 


The value you specify, the access code, is installation-dependent. In 
other words, it is not recognized by Prime software but will be 
recognized by software of another manufacturer. An access code is a 
single character that may be any one of the following: 

• An upper- or lowercase alphabetic character 

• A number 

• Any other character except right or left parentheses, an equal 
sign, a comma, an apostrophe, or a blank 

AC CES S is strictly a tape option. It defaults to a blank character, 
which signifies no protection. In the following example, you declare a 
tape object, SYSIN. It is located on logical device number 3 and has 
ANSI standard labels. You are working with the file MYFILE on tape 
number 1254. The access code is Y. 

> DECLARE SYSIN TAPE =(3), LABELS=(ANSI), FILEID=(MYFILE), 

VtLSER=(1254), ACCESS= (Y) 

> 


Note 


There is an accessibility field in both the VCLl and HDRl 
labels. These do not necessarily have the same value. The 
HDRl field is set by the ACCESS option. The VCLl fi e ld can be 
set by the PRIMOS LABEL command when you are initializing your 
reel of tape. (For more information on LABEL, see Chapter 6.) 


The CREATE and EXPIRE Options: These two options specify the creation 
and expiration dates of l abelled tape file. These dates are placed 
in the appropriate fields of the HDRl, EOFl, and BOVl labels, and 
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provide protection. Note that if the current date is earlier than the 
expiration date, the file cannot be overwritten. All creation and 

t re St ° red in MGNET (both internally and in label 
rields) in Julian format. 


Note 

The first file on your tape should have the latest expiration 
aate; when you overwrite a file, all succeeding data on the 
tape is considered invalid. 


The values you specify with CREATE and EXPIRE are one of the following: 

• A date in the form YYDDD, where YY represents the year, and EDD 
represents the day of the year (Julian date) 

• An asterisk (*), which indicates the current date 




MM/DD/YY, where MM represents the month (January is represented 
as 01), DD is the day of the month, and YY is the year 


CREATE and EXPIRE are strictly tape options. They both default to five 
0 s. This indicates that the file has already expired. (You have data 
on the tape that may be overwritten.) in the following example, you 
declare VITAL to be a tape object located on logical device 0. The 
tape has ANSI standard labels. With three subsequent MODIFY 
subcommands, you specify additional options for VITAL. The tape has 
two levels of labels, the owner of the tape is JOHN_RODDY, and the 
volume serial number is 847519. Finally, the creation date of the tape 
i Qft 7 6 current and the expiration date you specify is June 10, 


> DECLARE VITAL TAPE=(0), LABELS=(ANSI) 

> MODIFY VI T AL L EVEL=(2), 0WNER=(JCHN_RODDY) 

> MODIFY VITAL VCLSER= (8 47519) ” 

> MODIFY VITAL CREATE=(*), EXPIRE=(06/10/87) 


The GENERATION and V ERSION Options : The GENERATION option specifies an 
edition (the most current update) of a file. The VERSION option 
specifies a printing (a copy of the most current edition) of a file. 
Bothoptions are stored in the Generation and Generation-Version fields 
of the HDR1, EOFl, and EOVL labels. 


The values you specify for these 
nnnn (for GENERATION) and nn (for 
GENERATION are 0001 through 9999. 
through 99. GENERATION defaults to 


two options are numbers in the form 
VERSION). The valid values for 
The valid values for VERSION are 00 
0001 and VERSION defaults to 00. 
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The followng example illustrates the subcommand line for the 23rd 
printing of the 52nd edition of the tape object CIOJDS. It is an IBM 
labelled tape located on logical device number 4. You are working wi 
the file RAINBCW. 


> DECLARE CLOUDS TAPE= ( 4) .LABELS= (IBM),FILEID= (RAj NBQWjj. 
GENER ATION (00~52) jV^SIONf_(23| 

> 


The OFFSET Option: OFFSET specifies the length in characters of any 
field "in iTpfrysTcal tape block which precedes the data portion of that 
block. This option is for tape objects only. The value is a number 
from 0 to 99. The default value is 0. 

In the following example, you declare the tape object, BLUESKY, located 
on logical device number 1. You are working with file number 12, and 
each logical record is 80 characters long. The offset field preceding 
the data portion of each block is 10 characters long. Note that, in 
this example, the BFACTOR option is not specified so it defaults to a 
value of 1. However, because you specify OFFSET=(10), each physical 
block in this tape file will be 90 characters long. 

> DECT .ARE BLUESKY TAPE=(1) ,FILENO= (12) f LRECL= (80) ,OFFSET= (10) 

> 


Note 


If you specify LABELS=(ANSI) and LEVEL=(2), the value of OFFSET 
is stored in the Buffer Offset field of HDR2, EOF2, and EOV2 
labels. 


The SEQUENCE Option: This option specifies the order of a file within 
a set of files created simultaneously. This information corresponds to 
the ANSI file sequence number and the IBM data set sequence number, 
both of which are found on the HDRl label. 

SEQUENCE is a tape option for labelled tape files. You use SEQUENCE 
only when reading from these files. Ihe value you specify is a 
four-digit number, 0001 through 9999. The default value is 0001. In 
the following example, you declare a tape object, CURS, located on 
logical device number 2. Each logical record is 100 characters long. 
The tape contains ANSI standard labels, and you are working with the 
labelled file with the sequence number 0023. 

> PEGT.ARE OURS TAPE=(2) ,LRBCL=(100) ,LABELS= (ANSI) ,SB QUENCE= (0023) 

> 
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You use CHARACTERS when reading or writing 
odd-length physical blocks. All normal data transfers to or from a 
tape are performed in terms of words. Since a word is composed of two 
qytes (or characters), only an even number of characters can normally 
be transferred between memory and a tape. Note that an odd number of 
words equals an even number of characters (five words = 10 characters) 
To write a true odd-length physical block, the tape drive must te 
instructed to transfer only one character per word. To get a 
one-character-per-word string, a two-character-per-word string is 

doubled in length and each character from the original string is placed 
m the right-hand byte of a word. This accounts for the restrictions 
on the LRECL and BFACTOR options. (For more information, see the 

descriptions of the LRECL and BFACTOR options earlier in this chapter.) 


For output, when writing a tape file, CHARACTERS causes each block to 
be exploded from a two-char act er-pe r-wor d string to a 
one-character-per-word string. For input, when reading a tape file, 
each physical block is read as a one-character-per-block record and 
then imploded to a two-character-per-word string. See Figures 7-5 (A) 


Note 

If the CHARACTERS and EXCHANGE options are used together on 
input, CHARACTERS is processed first. On output EXCHANGE is 
processed first. 


CHARACTERS is strictly for tape objects. The value you specify is 
either 1 or 2. The default value is 2. Note that when you specify a 
value of 1, the value of LRECL * BFACTOR must be less than or equal to 
6i 4 3. In the following example, LEDGER is a tape object located on 
logical device number 4. The logical record length is 37 and the 
blocking factor is 11. You are working with the 20th file on the tape. 
block*^ 31091 block is to written as a true odd-length physical 

> DECLARE LEDGER TAPE=(4),LRECL=(37),BFACTOR=(ll),CHARACTERS=(1), 

> 


The EXCHANGE Option : When you write a physical block to tape on a 
Prime system, each high-order byte within a 16-bit word is written 
proceeding the low-order, or second byte. Certain operating systems of 
other manufacturers read or write the low-order byte first, and then 
read or write the high-order byte second. The EXCHANGE option allows 
you to compensate for this. On output, EXCHANGE causes pairs of bytes 
in a physical block to be swapped. On input, EXCHANGE causes each byte 
m a physical block to be swapped with its neighbor before any other 
processing takes place. See Figures 7-6 (A) and (B). 
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Note 

If the physical block has an odd-length, the last byte is not 
swapped. 


EXCHANGE is a tape option only. The value you specify is either 
PHYSICAL or NONE. The default value is NONE. In the following 
example, you declare a tape object, JJR, located on logical device 
number 6. The logical record length is 20 and you are working with the 
first file on the tape. All bytes in each word of the physical bloc 
are to be swapped since you specified PHYSICAL as the value for 
EXCHANGE. 


> DECLARE JJR TAPE=_(6_)_,IJbECL= (2 0), FILE NO= ( 1) , EXCHA^ E^ (PHYSICAL) 

> 


The MAXIO Option: This option specifies the maximum^ ^ number of 
characters - that the tape drive will attsnpt to read. All tape read 
operations request that the tape drive read and fill a buffer of ® 
certain size. On sane Prime systems, this number varies because of I/O 

window sizes. 

This option is for tape objects only. The value is a number between 
2000 and 12,288. The default value is 10,000 characters (5000 words). 
In the following example, you modify a prevrously declared tape object, 
JJR, with the MAXIO option. You specify a value of 9500. This means 
that the maximum number of characters requested on input is 9500. 

> MODIFY JJR MAXIO=(950 0) 

> 


The CONTROL Option: This option specifies the type of carriage-control 
used by a" spool file. The choices are either NONE or FORTRAN. NONE is 
the default. This option is valid for spool objects only. In the 
following example, the spool object PURPLE is declared with carriage 
control type FORTRAN. 

> DECLARE PURPLE SP0CL=(COLO RS), OONTR OL=(FORTRAN) 

> 


The DEFER Option: This option specifies the time to print a spool 
file. ?Ris option is useful if you wish to avoid printing a spool file 
at a busy period. The time must be provided in 24—hour format (for 
example, 1:00 p.m. =23:00 hours). The next example demonstrates a 
spool file which will be printed at 10:15 p.m. 

> MODIFY PURPLE DEFER=(2215) 

> 
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The CHARACTERS Option 

(A) Tape Output 

(B) Tape Input 

Figure 7-5 
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The EXCHANGE Option 

(A) Tape Output 

(B) Tape Input 

Figure 7-6 


7-55 


First Edition, Update 1 





































UPD5027-184 


18.4 

19.0 


The LINENOS Option : This option allows you to direct the spooler to 
print line numbers for every line printed in a spool file. This is an 
option for spool objects only and may take the values YES or NO (the 
default is NO). In the following example, a spool object, MIGRAINE, is 
declared with line numbers: 

> DECLARE MIGRAINE SPOCL=(HEADACHE), LINENOS=(YES) 


18.4 

19.0 


PAD Option 

The PAD option is for tape objects, 
files to tape and specifies the 
logical record. 


This option is used when writing 
padding character to use to fill a 


Mie default padding character in Rev. 19 operations is an 
industry-standard blank character (octal 040). In pre-rev. 19 

operations, the padding character selected is either a PRIME ASCII 
blank character (octal 240), an EBCDIC blank (octal 100), a BCD blank 
(octal 000) or, for BINARY files, zero (octal 000), depending on the 

user's reply given to the "ASCII, EBCDIC, BCD, or BINARY" question 

asked by MAGNET. 

The PAD option is specified in the following rtanner: 

PAI>( 'ccc'T) 

where the "c"s specify one or more characters and T is the type 
indicator. The apostrophes must be specified. 

Eight types of padding can be selected. These include 

industry-standard ASCII, BCD and EBCDIC as well as BINARY, DECIMAL, 
OCTAL and HEXADECIMAL numbers. These types are indicated by the 
following single letters: 

A industry-standard ASCII 
B BCD 

D decimal 

E EBCDIC 

H hexadecimal 

I binary 

O octal 

P PRIME ASCII 
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Thus, to specify an EBCDIC blank as a padding character, one could use 
any of the following: 


PAD=(' ’E) 

PAD=('01000000'I) 

PAD=('100'0) 

PAD=('064'D) 

PAD=('40'H) 


(for EBCDIC) 

(for binary) 

(for octal) 

(for decimal) 

(for hexadecimal) 


The type indicators (A, B, D, E, H, I, 0 or P) may be in either upper- 
or lowercase. If 'A', 'B', 'E' or 'P' is specified as a type, then 
only one character must appear between the quotes. If 
specified, eight digits must appear between the quotes. If D °* V 
is specified, three digits must appear between the quotes. If h is 
specified, only two digits must appear between the quotes. 


Note that if 'A', 'B', 'E' or 'P' is selected, upper- and lowercase 
characters are significant within the quotes. That is, 


PAD=('K'e) 

is not equivalent to 
PAD=('k'e) 

The first results in a padding value of octal 322, while the second 
results in a padding value of octal 222. 

Because BCD is only a 64-bit code, lowercase characters specified map 
to uppercase pad characters. 


The SAVE Subcommand 

You use SAVE to save a group of options in a PRIMUS global variable. 
MAGNET saves only those options that you declared or modified to a 
value other than their default. The subcommand line format is as 
follows: 

> SAVE object-name EXTERNAL=(global-variable-name) 


SAVE is analogous to: 

> DECLARE...EXTERNALS(...) 
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Yoii must always specify the EXTERNAL cption on the SAVE subcommand 
line. The value of EXTERNAL is a PRIMDS global-variab le-rame. (For 

thil chfS^ °pA de f cri F tion of the EXTERNAL - option iiFlier in 

this chapter. For additional information on PRI1VDS global variables, 

refer to Ili^JPLjjser^Guide.) m the following eLnple, Si of the 
options previously specified for JJR are stored, along with their 
values, m the global variable name .SUE: 


> 

> 


SAVE JJR EXTERNALS ( .SUE) 


The LOAD Subcommand 

You use this subcommand to load a user-defined translation table. The 

u f these tables are v ' w ' x ' Yf .and Z. MAGNET accesses 
les when you specify them as edit tokens in a TRANSLATE 
subcommand. (For more information, see the description of the 

S^f-d U f C °Tr d e fi ier in this chapter, and also Appendix A.) 

first 256 bftlTt * I™ table 1S 512 hytes (256 words) long. The 
~5 b l 56 byt A | jsed wh en you are reading from a tape; the last 
256 bytes are used when writing to a tape. 

SL mu ? bapeci ^ three options on the LOAD subcommand line. They are 
TYPE, LINES, and DISK. You may specify than in any order. The DISK 
option identifies the PRIMDS filename or pathname that contains your 

Th^rnAn 1 on , table •, hINES and TYPE are described later in this chapter. 
The LOAD subcommand line format is as follows: P 


> LOAD table-name TYPE= < 


(BIN) 

(CHAR) 

(OCT) 

(DEC) 

(HEX) 


LINES=(n), DISK= (pathname) 


I n th^ PE d?S specifles the interpretation of the characters 
i?no v k fi ifr y ° U name as the value for DISK in the LOAD subcommand 
I™-' Y ? a use JYPE only with the LOAD subcommand, and you must always 

"° <fe£aUlt y0U mUSt ™ ~ «* ^ 


• BIN (binary number character strings) 

• CHAR (ASCII character strings) 

• OCT (octal number character strings) 

• DEC (decimal number character strings) 

• HEX (hexadecimal number character strings) 
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All binary digit strings must be eight digits (or ^acters) long. 
All octal and decimal digit strings must be three digits or 
characters) long. All hexadecimal digit strings must be two digits (or 

characters) long. 


The LINES Option: This option tells MAGNET how many lines to read in 
the dis k H Ie~~you name as the value for DISK in the IDAD subcotratand 
line. You use LINES only with the LOAD subcommand, and you must always 
specify it. The value is a number that is a divisor of 512, namely 1, 
2, 4, 8, 16, 32, 64, 128, 256, or 512. There is no default value. The 
number of binary, octal, decimal, or hexadecimal numbers (or 
characters) that must appear on each line is 512 divided by the val e 
of the LINES option. 


Note 


For readability, it is not recommended that a small line count 
(1, 2, 4, 8, or 16) be used, especially if you specify 

TYPE=(BIN). 


Creating Tran slation Tables : You use a translation table to: 

• Convert from one character set to another 

• Convert from upper to lowercase and vice versa 

• Set or reset certain bits in every byte of a character string 


An EBCDIC to ASCII conversion table is an example of a tool you can use 
to convert from one character set to another. (For more information, 
see Appendix A.) An example of case conversion can be found in the 

TRANSLATE function of Pl/I: 


STRING = TRANSLATE ( 


SIRING, 

' ABCDEFGH I JKLMNOPQRSTUVWXYZ', 

'abcdefghij klmnopqrstuvwxyz'); 


The final function of a translation table, that of 
found in the industry-compatible ASCII to Prime 
table. (See Appendix A.) 


setting bits, is 
ASCII translation 


The syntax you must use for creating your own translation tables is 
extremely rigid and precise. You have a choice of representing your 
table in ASCII character strings or binary, octal, decimal, or 
hexadecimal number character strings. 

The ASCII character string rpresentation is useful for case conversion 
and special symbol translation. With this format, you place the same 
number (n) of characters on 512 divided by n lines. ^ery incoming 
character to be translated actually rpresents an eight-bit number 
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£2"*° 2 l 5 - u This number is used as an index into the table to 

find the output character (the translated character). For example a 

leSfA° n thmuah t0 7 00nVert i r ? 11 l0W6r t0 u P^ rcase w °uld have the 
letters A through Z in absolute table positions start-inn frnm n 
represented by 225 through 250 decimal. starting from 0, 

Each translation table must be 512 bytes long. The first set of 256 
haracters forms an input table for use when reading from a tape The 

5Tta2 m i 6 chara ? ters forms an oufc P ut table for use when^iitiSg 
table S’ J!?'TT S 0336 ° f the l0wer to uppercase conversion 
mnS • i , to make no seuse to have an output table. Still, you 

include on f* , 0ne solution is to include a number of blank lines. 
Each sequence of characters on every line must begin in column 1. 


Note 


It is important to keep in mind that blanks 
They are treated as characters. 


are significant. 


The binary number character string representation is useful when you 

c S a " cters be printed (control characters, for 

example). Each sequence of binary number character strings must begin 
in column 1. Each binary number may include the ASCII characters 0 and 

_ , f* ch briber must be exactly eight characters long and must be 

separated frcm its neighbor by exactly one space. 


The octal, decimal, and hexadeciiral 
representations are exactly the same as 
except: 


number character string 
the binary rpresentation 


• For octal numbers, the characters 0 through 7 are allowed. 

• For decimal numbers, the octal numbers plus 8 and 9 are allowed. 

• For hexadecimal numbers, the decimal numbers plus A throuqh F 

and a through f are allowed. y 


These representations are also useful when you translate characters 

hi a r . Cann ° t ^ pr ^ ted ' 311(3 P rovide a more compact notation than 
I 8 * ln binary representation, all numbers must begin in 

column 1 and must be separated frcm their neighbors by only one space. 
As an example, consider the industry-standard ASCII to Prime ASCII and 
the Prime ASCII to industry-standard ASCII translationt£ies “E 
ppendix A. These tables include binary, octal, decimal, and 
hexadecimal representations. A user table which included all the 
hexadecimal numbers frcm both tables in the Appendix would comprise a 

tahle. Ml the octST decimal, or 
numbers would also comprise valid tables. y 
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Suppose that the industry-standard ASCII-Prime ASCII table was found in 
a disk file, ASCBIN.TABLE. Also, suppose that this table consists of 
binary digit strings, eight per line (64 lines). The LOAD subcommand 
line to load this file (containing the table) into internal table V 

(edit token V) is: 


> LOAD V nT.c;K= ( AqC^^.T^LEj J _TYPE= ( BIN), LINE S=_(64] 

> 





The CLO SE S ubcomma nd 

You use this subcommand to close a tape, disk or spool object which may 
have been left open by an abnormal condition or by your depressing the 
break key. For tape objects, an internal MAGNET switch signifying that 
the tape is open, is reset. For disk and spool objects, the respective 
files are truncated (if open for write) and are then physically closed, 
in the following example, a MOVE subcommand was issued to move data 
between a tape file, TFILE, and two other objects, DFILE, a disk file 
and SFILE, a spool file. Assuming that an abnormal end to the MO 
subcommand occurs, the CLOSE subcommand can be issued three times to 
close each of the three objects. 


> MOVE TFILE SFI LE DFILE 


18.4 

19.0 


> LIST ITEMS=(OPEN) 

object-names 


TFILE 

DFILE 

SFILE 

> CLOSE TFILE 

> CLOSE SFILE 

> CLOSE DFILE 

> LIST 


object-names 


TFILE 

DFILE 

SFILE 


type open status 


Tape Open / Read 

Disk Open / Write 

Spool Open / Write 


type open status 


Tape Closed 
Disk Closed 
Spool Closed 



rhe SILENT and NOISY Subcommands 


rhe two subcommands, SILENT and NOISY, control the printing of severity 
1 messages at your terminal. Issuing the SILENT subcommand is 
panivalent to soecifvinq "-SILENT" on the PRIMOS command line used to 
invoke MAGNET (see Appendix B, COMMAND LINE OPTIONS AND BATCH JOBS). 
The NOISY subcommand enables the printing of severity 1 messages; this 


18.4 

19.0 
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is the default mode for MAGNET if "-SILENT" is 
PRIMOS command line. 


not specified on the 


18.4 

19.0 


THE BREAK KEY 


MAGNET contains an internal break key 
the break key at any time you are 
MAGNET subcommand level where you can 
from MAGNET, use the QUIT subcommand. 


(OONTRQL-P) handler. If you type 
within MAGNET, control returns to 
enter more commands. To exit 
described earlier. 


SAMPLE MAGNET SESSION 


The following is a sample MAGNET terminal session. Each step of the 
session is explained in procedural format following the example. 

OK, MAGNET 
[MAGNET Rev 18.3] 

> DECLARE SYSI N DISK=(DC>INTERIQR>NATL PARKWOfiRMI'm?) .T,RFrr^ f 1 

> MODIFY SYSIN~ FORMA^TFIXEDT - - -— 

> DECLARE SYSQJT1 T APE=(3) ,DE NSITY= (1600) ,FILENO= (4) ,LRE)CL= (] 41 ) 

> MO^_SYSOTl_BFA^^Jll) J C^CT^a)^EXCHANG^lYESl- 

> MODIFY SjgOJTl FO RMAT= (FIXED) ,EUF FERS=(3) .POSTAO 1 TON=7rTNr mn' 

> TRANSLATE SYSCUT1 ( A120.10(F*1 .Q4.37F ,A4) 

> 2 . 

> DE CLARE SYSOJT2 TAPE=(3),DENSITY=(1600),FILENO =(l),LRECL=(141) 

> MODIFY SYSCUT2 BFACTOR= (11) , CHARACTERS (1 ^ f (y^c;) 

> MODIFY SYSCUT2 FORMAT^ (FIXED) ,VIS UAL= ( NP^OOOT) 

> MODIFY SYS0UT2 POSTACTION=(UNLOAD) 

> TRANSLATE SYSOUT 2 (A120.r0(F*Q .04-iwn 

> /*_ 

> MOVE SYSIN SYS0UT1 

>Z!- 

> DECLARE AUDIT_TAPE_JL TAPE=(0) ,FILENO=(l) ,RECORDNO=m 

> DECLARE AUDI T_ TAPE_2 TAPE= (1) , FILENO^T RECORDNO^'Tit 

> COPY AUDIT_TAPE_1 AUDIT_TAPE_2 AM3UNT=(274) 

> /* — 

> POSITION AUDIT_TAPE_1 M0DE= (ABSOLUTE) 

> POSITION AUDIT_TAPE_2 M0DE=(ABSOLUTE) 

> &JIT 

OK, 
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the magnet subsystem 


of the Session 


1 . 


2 . 


First, declare SYSIN to be a disk object. The pathname of 

SYSIN is DC >INTERIOR>NATL_PARK>YOSEMITE. By * 

logical record in this file is . 

The maximum length of each logical record is 

With the MODIFY subcommand, you change the format of this disk 
file to fixed-length records. Each logical record is now 
defined to be exactly 128 characters. 


3. A comment subcommand (/*) is provided for readability. 


4. 


5. 


You declare SYSCUTl to be a tape object, residing on logical 
device number 3. It has a density of 1600 bpi. Each logical 
record contains 141 characters. This tape file is the fourth 
file on the tape. 

The next two MODIFY subcommands set the blocking factor to 12 
and the record format to FIXED. Three I/O buffers are being 
used. After use, the tape will be unloaded (dismounted). 
Because 11*141 equals 1551, an odd number, an extra null 
character would ordinarily be inserted ty Prime ^ hardw;are. 
To circumvent this problem, you specify CHARACTERS-(1) for 
true odd-length records. Also, this tape file will be 
transferred to a computer which swaps high and low-order 
bytes. Thus, you specify EXCHANGED (YES). 


6 . 


7. 


ASCII 
and 4 


8 . 


The desired translation is 120 industry-compatible 
characters, 10 asterisks, 4 binary characters, 3 spaces, 
industry-compatible ASCII characters. 

You declare SYSCUT2. The translation is exactly the same as 
SYSCUTl, except for two differences. First of all, you do n 
specify any I/O buffers. Second, you do specify an external 
visual identification, NPCA0001. This object is declared as 
an "extension" to SYSCUTl so that another tape can be ready if 
the first tape becomes full. 

The information in the disk object SYSIN is moved to the 
destination object SYSCUTl. Should end-of-tape occur on 
SYSCUTl, messages are sent to the operator requesting that the 
first tape be dismounted and the second tape (with external 
visual identification NPCA0001) be mounted. The operator 
receives these messages because the default communications 
mode is -OPERATOR on the PRIMUS command line. 


9. You declare two new objects, AUDIT_TAPE_JL and AUDIT_TAPE_2, as 
tape objects on logical devices 0 and 1, respectively. You 
have specified both FILENO and RECORDNO values for these two 
objects. 
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10. The first 274 
AUDI T_TAPE_2. 


11 . 


12 . 


files on AUDI T_TAPE_JL are copied to 


Both AUDIT_TAPE_1 and AUDIT_TAPE_2 are positioned acoording to 
values you specified for each object's FILENO and RECORDNO 
options. They are positioned absolutely, which in this 
particular example causes the two tapes to be rewound. 

SJSS subcommand ends your MAGNET session and returns you to 
PRIMOS command level. QUIT causes all dynamic space occupied 

by objects and I/O buffers to be returned to the free memory 
pool • 


18.4 

19.0 


MAGNET MESSAGES 


There are four types of messages generated by MAGNET that you 
when you work with the subsystem. They are: 


may 


see 


Severity 0 Hus identifies a message. No error condition has 
occurred. These messages generally signal an operation complete 
or the detection of the break key typed. 


Severity 1 This identifies a warning. Whatever operation is 
in progress at the time you receive the warning continues. This 
means that you always retain in MAGNET and sometimes, depending 
on what happened, you remain within the subcomnand. 


• Severity 2 - This identifies an unoorrectable error that 
occurred within a subcommand. You are returned to MAGNET at 
subcommand level. 


• Severity 3 - This identifies a fatal error. 
PRIMUS. 


You are returned to 


All MAGNET messages are in this format (nnn 
identification number): 


is 


the 


message 


** Message nnn, Severity = n [, Object-name = name ] 
message to be printed 


The following is a listing of all MAGNET messages, 
response has been provided for each message, 
description has been provided for each message 
self-explanatory. 


A suggested user 
In addition, a 
that is not 


** Message 001, Severity = 3: 

Invalid PRIMUS command line. 

Suggested User Response: Retype a correct PRIMUS command line. 
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** Message 002, Severity = 2: 

Error while reading subcommand. 

Description; This indicates a possible terminal I/O error. 

Suggested User Response: Retype the subcommand line. If the problem 
persists, contact your System Administrator. 


** Message 003, Severity = 2:^ 

Invalid subcommand (ignored). 

Description; You typed an invalid subcommand line. 

Suggested User Response: Retype the subcommand line. If the problem 
persists, contact your System Administrator. 


18.4 
19.0 

Description: A MAGNET subcommand was unable to perform the operation 
you requested. Normally, you receive a message before this one that 
indicates the specific type of problem. 

Suggested User Response: You must reenter MAGNET and try your MAGNET 
operation(s) again. If the problem persists, contact your System 

Administrator. 


** Message 004, Severity = 3: 
A subcommand has aborted. 


** Message 005, Severity = 1: 

Warning: additional errors may occur. 


** Message 006, Severity = 2: 

Invalid character(s) in object-name. 

Suggested User Response: Retype the subcommand line using valid 
characters in your object-name(s). 
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** Message 007, Severity = 2: 

An object-name is too long or too short. 

fnw 9 oP 6 i USer ^P° ns< :i. Retype the subcommand line, making sure that 
any object-name(s) specified are no longer than 32 characters. 


** Message 008, Severity = 2: 

EXTERNAL option within global variable is invalid. 


Description: The PRIMUS global variable named in the EXTERNAL option 
contains the word EXTERNAL. Only one level of EXTERNAL is allowed. 


Suggested User Response: 
EXTERNAL does not appear. 


Correct your global variable so that the word 



** Message 009, Severity = 2: 

EXTERNAL variable name not found. 


Description: The PRIMUS global variable named in the EXTERNAL option 
was not found. 


18.4 

19.0 


Suggested User Response: Make sure that you have the correct 
variable file activated. Next, make sure that the particular 
variable exists in the file. 


global 

global 


** Message 010, Severity = 3: 

Abnormal halt. Contact your systan administrator. 

Description: An extremely unusual and uncorrectable condition occurred 
within MAGNET. 

Suggested User Response: Save all pertinent information, such as 
output frcm OUMOUTPUT, EMSTK, and EM commands. Give all of this 
information to your System Administrator. 


** Message Oil, Severity = 3: 

Abnormal halt. Sane disk or spool files may be open. 

Description: An extremely unusual and uncorrectable condition occurred 
within MAGNET. 

Suggested User Response: Save all pertinent information such as output 
from CDMOUTPUT, EMSTK, and PM commands. Give all of this information 
to your Systan Administrator. In addition, check for open disk files. 
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** Message 012, Severity = 2: 

A tape is hardware write - protected. 

Suggested User Response: Put a write-enable ring on your tape(s). 


** Message 013, Severity =2: 

A tape is software write - protected. 

Suggested User Response: Set the value of the PROTECT option for your 
tape(s) to NONE. 


** Message 014, Severity = 2: 

A disk file is write - protected. 


Suggested User Response: If you own the directory where the disk 
file(s) are located, change the protection attributes to enable write 
(W) access. If you are a non-owner, contact the owner or the System 
Administrator to have the protection attributes changed. 


** Message 015, Severity = 2: 

A disk file is read - protected. 

Suggested User Response: If you own the directory vfaere the disk 
file(s) are located, change the protection attributes to enable read 
(R) access. If you are a non-owner, contact the owner or the System 
Administrator to have the protection attributes changed. 


** Message 016, Severity = 3: 

A run-away tape condition exists. 

Description: A read, forward-space file, or forward-space record 
operation is executing indefinitely, which eventually causes the tape 
to be pulled from the supply reel. This only occurs when your tape is 
blank (read, forward-space record), or when no more filanarkers are 
found on the tape (forward-space file). 

Suggested User Response: Press the terminal BREAK key immediately. 
Unassign the tape drive (s) and inmediately reassign them. This 
suddenly causes the tape drive (s) to halt, tut you still need to 
reenter MAGNET to continue your magnetic tape operations. 



7-67 


First Edition, Update 1 





UPD5027-184 


** Message 017, Severity = 2: 

A tape dismount (unload) operation has aborted. 

Description: Either you or the operator typed REPLY -tape ABORT in 
response to a dismount request. 

fn 9 ^ te 5 Ki Ser Response: Depending on the circumstances, this may be 

an acceptable response. y 


** Message 018, Severity = 2: 

A tape mount operation has aborted. 


Description: Either you or the operator typed REPLY -TAPE ABORT in 
response to a mount request. 

Suggested User Response: Depending on the circumstances, this may be 
an acceptable response. 1 


** Message 019, Severity = 2: 

An object was not previously declared. 

Suggested User Response: Declare the object(s). 


** Message 020, Severity = 2: 

An object was already declared. 


Suggested User Response: You cannot declare an object more than 
Use the MODIFY subcommand to change option values. 


once. 


** Message 021, Severity = 2: 

Memory allocation error: delete seme objects. 


Description: You have used all available manory for objects. 


Suggested User Response: Either delete same objects or reduce the 
value of the BUFFERS option for declared tape objects. 


** Message 022, Severity = 2: 

Error while freeing dynamic memory. 

Description: An error occurred when either seme buffers (BUFFERS 
option), or the space occupied by a tape, spool, or disk object, was 
returned to the free storage area. 
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Suggested User Response: If this occurred during a DELETE operation, 
give a LIST subcommand to make sure that the object was deleted. If 
the obiect was not deleted, reissue the DELETE subcommand. If this 

error occurred during some other operation, try ttie operation again. 
If the problem persists, contact your System Administrator. 


** Message 023, Severity = 2: 

Uncorrectable tape read error. 

Description: A tape READ operation was unsuccessful after 10 attempts. 

Suaqested User Response: Check for a correct density setting on the 
tape drive. If the density setting is correct, your tape is either bad 
or improperly formatted. There may also be a problem with either the 
tape^rive o? controller. If the problem persists, contact your System 

Administrator. 


** Message 024, Severity = 2: 

Uncorrectable tape write error. 

Description: A tape WRITE operation was unsuccessful after 10 


attempts. 



Administrator. 


** Message 025, Severity - 2: 

Uncorrectable tape control error. 

Description: A tape control operation was unsuccessful. 

Suggested user Response: Check for a correct density setting on the 
tape drive. If the density setting is correct, your tape is either bad 
or ^improperly formatted. There may also be a problem with either the 
tape drive or controller. If the problem persists, contact your System 

Administrator. 


18.4 

19.0 


1 —69 


First Edition, Update 1 






UPD5027-184 


** Message 026, Severity = 2: 

No room is available in the object list. 


Description: 
maximum). 


You are attempting to declare more than 100 objects (the 


Suggested User Response: Delete any objects you no longer need. 


** Message 027, Severity = 2: 

Error while setting up default options. 

Suggested User Response: Reissue your DECLARE subcommand, 
problem persists, contact your System Administrator. 


If the 


** Message 028, Severity = 2: 

Error while parsing the option list. 


Suggested User Response: Retype 
correcting any errors that exist. 


your DECLARE or MODIFY subcommand. 


** Message 029, Severity = 1: 

Option conflict (DENSITY & TRACKS?). 

Description: A conflict exists among various options. 


Suggested User Response: Check your options for 
change option values with the MODIFY subcommand. 


compatibility and 


** Message 030, Severity = 3: 

Subsystem aborting- Check for open files. 

Shnn^^ i0n: A . su 5 coiraT1and just issued has aborted. Normally, you 
S^-?- haVe received anot her message prior to this one indicating the 
4 -i er £° r * MAGNET cannot recover from this error, and 
consequently has returned you to PRIMOS command level. 

SJSSS? 3 US ^ r Response: Check for open files. Attempt to correct any 
thp°nrohi^ r ° ^ an ?* p eenter MAGNET and issue your subcommand again. If 
the problem persists, contact your System Administrator. 
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** Message 031, Severity = 2: 

The COPY subcommand will abort. 


Suggested User Response: You should have received an message prior to 
this one indicating the specific error. Correct the problan and 
reissue the subcommand. 


** Message 032, Severity = 2: 

The DECLARE subcommand will abort. 

See Message 031. 


** Message 033, Severity = 2: 

The DELETE subcommand will abort. 


See Message 031. 


** Message 034, Severity = 2: 

Tape drive not assigned. 

Suggested User Response: Assign all tape drive(s) at PRIMUS command 
level with the ASSIGN command. Then, reenter MAGNET and reissue the 
command(s). 


18.4 

19.0 


** Message 035, Severity = 2: 

The LOAD subcommand will abort. 


See Message 031. 


** Message 036, Severity = 2: 

The MODIFY subcommand will abort. 

See Message 031. 


** Message 037, Severity = 2: 

The MOVE subcommand will abort. 

See Message 031. 
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** Message 038, Severity = 2: 

The POSITION subcommand will abort. 

See Message 031. 


** Message 039, Severity = 3: 

The QUIT subcommand will abort. 

See Message 031. 


** Message 040, Severity = 2: 

The READ subcommand will abort. 

See Message 031. 


** Message 041, Severity = 2: 

The SAVE subcommand will abort. 

See Message 031. 


** Message 042, Severity = 2: 

The TRANSLATE subcommand will abort. 

See Message 031. 


** Message 043, Severity = 2: 

The WRITE subcommand will abort. 

See Message 031. 


** Message 044, Severity = 2: 

Error while analyzing the ACCESS option. 

Description: The READ or MODIFY subcommand found an er-or when it 
analyzed this option. 

Suggested User Response: Retype the subcommand line with this option 
corrected. * 
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** Message 045, Severity = 2: 

Error while analyzing the BFACTOR option. 

See Message 044. 


** Message 046, Severity = 2: 

Error while analyzing the BUFFERS option. 

See Message 044. 


** Message 047, Severity =2: 

Error while analyzing the BYPASS option. 

See Message 044. 


** Message 048, Severity =2: 

Error while analyzing the CHARACTERS option. 

See Message 044. 

18.4 

19.0 


** Message 049, Severity = 2: 

Error while analyzing the CREATE option. 

See Message 044. 


** Message 050, Severity =2: 

Error while analyzing the DENSITY option. 

See Message 044. 


** Message 051, Severity = 2: 

Error while analyzing the DISK option. 

See Message 044. 


** Message 052, Severity = 2: 

Error while analyzing the EXPIRE option. 

See Message 044. 


7-73 


First Edition, Update 1 






UPD5027-184 


18.4 

19.0 


** Message 053, Severity = 2: 

Error while analyzing the EXTERNAL option. 

See Message 044. 


** Message 054, Severity = 2: 

Error while analyzing the FILEID option. 

See Message 044. 


** 


Message 055, Severity = 2: 

Error while analyzing the FORMAT option. 


See Message 044. 


** Message 056 has not yet been assigned. 


** Message 057, Severity = 2: 

Error while analyzing the GENERATION option. 

See Message 044. 


** Message 058, Severity = 2: 

Error while analyzing the LABELS option. 


See Message 044. 


** Message 059, Severity = 2: 

Error while analyzing the LEVEL option. 

See Message 044. 


** Message 060, Severity = 2: 

Error while analyzing the LRECL option. 

See Message 044. 
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** Message 061, Severity =2: 

Error while analyzing the MAXIO option. 

See Message 044. 


** Message 062, Severity =2: 

Error while analyzing the NEXTCHAIN option. 

See Message 044. 


** Message 063, Severity =2: 

Error while analyzing the CWNER option. 

See Message 044. 


** Message 064, Severity =2: 

Error while analyzing the PARITY option. 

See Message 044. 


** Message 065, Severity =2: 

Error while analyzing the POSTACTION option. 


18.4 

19.0 


See Message 044. 


** Message 066, Severity =2: 

Error while analyzing the PREACTION option. 

See Message 044. 


** Message 067, Severity =2: 

Error while analyzing the PREVCHAIN option. 

See Message 044. 


** Message 068, Severity =2: 

Error while analyzing the PROTECT option. 

See Message 044. 
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** Message 069, Severity = 2: 

Error while analyzing the TAPE option. 

See Message 044. 


** Message 070, Severity = 2: 

Error while analyzing the TRACKS option. 


See Message 044. 


** Message 071, Severity = 2: 

Error while analyzing TRANSLATE token(s). 

Description: The list of edit tokens in your TRANSLATE subcommand 
contains one or more errors. For example, you may have typed A$ 
instead of A4. 

Suggested User Response: Retype the TRANSLATE subcommand with all 
errors corrected. 


** Message 072, Severity = 2: 

Error while analyzing the VERSION option. 

See Message 044. 


** Message 073, Severity = 2: 

Error while analyzing the VISUAL option. 

See Message 044. 


** Message 074, Severity = 2: 

Error while analyzing the VOLSER option. 

See Message 044. 


** Message 075, Severity = 2: 

External names must begin with periods. 

Suggested User Response: Retype the SAVE, DECLARE, or MODIFY 
subcommand with a correct PRIMDS global variable name as the value for 
the EXTERNAL option. 
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** 


Message 076, Severity = 2: 

Invalid subcommand or characters. 


Suggested User Response: Retype the subcommand line. 


** Message 077, Severity = 2: 

An error occurred while saving into a variable. 

Description: An error occurred when the SAVE subcommand tried to save 
an object's options and values. 


Suggested User Response: Make sure that your global variable file is 
activated and not full. Try the SAVE subcommand again. If the problem 


persists, contact your System Administrator, 



** Message 078, Severity =2: 

No more room exists to declare this object. 

Description: No more room is available in the free storage area to 
declare this object. 

Suggested User Response: Delete some objects or modify the values of 
the BUFFERS option of any previously declared tape objects. 


18.4 

19.0 


** Message 079, Severity = 3: 

Subsystem aborting- no files are open. 

Description: A subcommand just issued has aborted. Normally, you 
should have received another error message prior to this one indicating 
the specific error. MAGNET cannot recover from this error, and 
consequently has returned you to PRIMDS command level. 


Suggested User Response: Attempt to correct any reported problems. 
Reenter MAGNET and try your subcommand again. If the problan persists, 
contact your System Administrator. 



** Message 080, Severity = 1: 

An invalid command line option will be ignored. 

Suggested User Response: No corrective action is necessary. However, 
if you incorrectly typed -SILENT or -USER you should give the QUIT 
subcommand and reenter MAGNET with the correct MAGNET command line 
options. 
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** Message 081, Severity = 1: 
Execution will continue. 


** Message 082, Severity = 2: 

Error while analyzing the FILENO option. 

See Message 044. 


** Message 083, Severity = 2: 

The RENAME subcommand will abort. 

See Message 031. 


18.4 

19.0 


** Message 084, Severity = 1: 

Circular chaining is not permitted. 

• The values Y°u specified for the PREVCHAIN and/or 
NEXTCHAIN options are the same as the object-name you are currently 
specifying in a DECLARE or MODIFY subcommand. 

Suggested User Response: Execution continues, but the NEXTCHAIN and/or 
PREVCHAIN options are not set. (You have to modify than.) 


** Message 085, Severity = 2: 

The wrong tape is mounted. 

Suggested User Response: Try the entire subcommand operation again 
with the correct tape mounted. 


** Message 086, Severity = 1: 

The ACCESS option is not initialized. 

Suggested User Response: If you meant to, give this option a value. 
Otherwise, ignore this message. 


** Message 087, Severity = 1: 

The BFACTOR option is not initialized. 

See Message 086. 
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** Message 088, Severity =1: 

The BUFFERS option is not initialized. 

See Message 086. 


** Message 089, Severity = 1: 

The BYPASS option is not initialized. 

See Message 086. 


** Message 090, Severity = 1: 

The CHARACTERS option is not initialized. 

See Message 086. 


** Message 091, Severity =1: 

The CREATE option is not initialized. 

See Message 086. 


** Message 092, Severity =1: 

The DENSITY option is not initialized. 

See Message 086. 


** Message 093, Severity =1: 

The DISK option is not initialized. 

See Message 086. 


** Message 094, Severity = 1: 

The EXPIRE option is not initialized. 

See Message 086. 


** Message 095, Severity =1: 

The EXTERNAL option is not initialized. 

See Message 086. 
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** Message 096, Severity = 1: 

The FILEID option is not initialized. 

See Message 086. 


** Message 097, Severity = 1: 

The FORMAT option is not initialized. 

See Message 086. 


** Message 098 has not yet been assigned. 

** Message 099, Severity = 1: 

The GENERATION option is not initialized. 

See Message 086. 


** Message 100, Severity = 1: 

The LABELS option is not initialized. 

See Message 086. 


** Message 101, Severity = 1: 

The LEVEL option is not initialized. 

See Message 086. 


** Message 102, Severity = 1: 

The LRECL option is not initialized. 

See Message 086. 


** Message 103, Severity = 1: 

The MAXIO option is not initialized. 

See Message 086. 
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** Message 104, Severity =1: 

The NEXTCHAIN option is not initialized. 

See Message 086. 


** Message 105, Severity = Is 

The OWNER option is not initialized. 

See Message 086. 


** Message 106, Severity =1: 

The PARITY option is not initialized. 

See Message 086. 


** Message 107, Severity =1: . 

The POSTACTION option is not initialized. 


See Message 086. 


18.4 

19.0 


** Message 108, Severity =1: 

The PREACTION option is not initialized. 

See Message 086. 


** Message 109, Severity =1: . 

The FREVCHAIN option is not initialized. 


See Message 086. 


** Message 110, Severity = Is 

The PROTECT option is not initialized. 

See Message 086. 


** Message 111, Severity =1: 

The TAPE option is not initialized. 

See Message 086. 
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** Message 112, Severity = 1: 

The TRACKS option is not initialized. 

See Message 086. 


** Message 113, Severity = 1: 

TRANSLATION has not been specified. 


Suggested User 
if you meant to. 


Response: Specify a translation (TRANSLATE subcommand) 
Otherwise, ignore this message. 


** Message 114, Severity = 1: 

The VERSION option is not initialized. 

See Message 086. 


18.4 

19.0 


** Message 115, Severity = 1: 

The VISUAL option is not initialized. 

See Message 086. 


** Message 116, Severity = 1: 

The VQLSER option is not initialized. 

See Message 086. 



** Message 117, Severity = 1: 

One or more options will be ignored. 

Suggested User Response: Use the DISPLAY subcommand to check that all 
option values are correct. Then, use the MODIFY subcommand to modify 
option values if necessary. y 


** Message 118, Severity = 2: 

Error while analyzing the REOORDNO option. 

See Message 044. 

# 
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Message 119, Severity = 2: 

Error while analyzing the OFFSET option. 


See Message 044. 


** Message 120, Severity = Is 

The OFFSET option is not initialized. 

See Message 086. 


** Message 121, Severity = 2: 

First option not DISK/TAPE/SBOOL, EXTERNAL or LIKE. 

Suggested User Response: Retype the DECLARE subcommand line with DISK, 
TAPE, or EXTERNAL as the first option specified. 



** Message 122, Severity =2: 

Disk options are invalid for non-disk objects. 

Suggested User Response: Retype the subcommand line with valid tape or 
spool options. 


** Message 123, Severity =2: 

Tape options are invalid for non-tape objects. 

Suggested User Response: Retype the subcommand line with valid disk or 
spool options. 


** Message 124, Severity = 2: 

Error while analyzing the AMOUNT option. 

See Message 044. 


** Message 125, Severity = 1: 

The AMOUNT option is not initialized. 

See Message 086. 



18.4 

19.0 
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** Message 126, Severity = 2: 

No objects have been declared. 

Suggested User Response: You must first declare all objects before 
using than. 


** Message 127, Severity = 1: 

All options following EXTERNAL are ignored. 

Suggested User Response: Since all options that follow the EXTERNAL 
option in your DECLARE or MDDIFY subcommand have been ignored, use the 
DISPLAY subcommand to check that all option values are correct. If 
necessary, use the MDDIFY subcommand to change option values. 


** Message 128, Severity = 2: 

Options must be specified. 

Description: You typed a DECLARE or MDDIFY subcommand without 
specifying any options. 

Suggested User Response: Retype the subcommand line specifying 
options. J ^ 


** Message 129, Severity = 2: 

This object has too many options to save. 

Description: The object you specified in the SAVE subcommand contains 
option values which exceed 1,024 characters (the maximum allowed for a 
PRIMOS global variable). 

Suggested User Response: Set a few options back to their default 
values, and try to issue the SAVE subcommand again. 


** Message 130, Severity = 2: 

Global variable file bad or uninitialized. 

Description: This message usually indicates that you do not have a 
global variable file activated. 

Suggested User Response: Activate your global variable file at PRIMDS 
level with the DEFINE_GVAR command. if the problon persists, your 
global variable file contains bad data and must be re-created. 
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** Message 131, Severity = 2: 

Global variable file is too small or full. 


Description: There is not enough roan left in your global variable 
file to save an object with its option values. 


Suggested User Response: To make room in your global variable file, 
use the PRIMUS command DELETE_VAR to delete sane variables. 


** Message 132, Severity = 2: 

An invalid translation table was specified. 


Suggested User Response: Retyps the IDAD subcommand, specifying V, W, 
X, Y, or Z as the user translation table. 


** Message 133, Severity = 2: 

Error while analyzing the LINES option. 

See Message 044. 



** Message 134, Severity =2: 

Error while analyzing the TYPE option. 

See Message 044. 


** Message 135, Severity = 1: 

The LINES option is not initialized. 


See Message 086. 


** Message 136, Severity = 1: 

The TYPE option is not initialized. 

See Message 086. 



18.4 

19.0 
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** Message 137, Severity = 2: 

Error while opening a disk file. 


Suggested User Response: 


• If you are trying to read from a disk file, check that the file 
exists and that the protection and/or access control for this 
file is correctly set. 


• If you are trying to write to a disk 
protection and/or access control, 
full. 


file, check for proper 
Check that the disk is not 


** Message 138, Severity = 2: 

Error while reading from a disk file. 


Suggested User Response: Check that the protection 
control for this disk file is correctly set. 


and/or 


access 


** Message 139, Severity = 2: 
Data conversion error. 


Description: Bad character(s) were detected while reading from a disk 
file into a user translation table. 


Suggested User Response: Check your disk file for valid characters. 
Binary numbers may contain the characters 0 or 1 only. Octal numbers 
may contain the characters 0 through 7 only. Decirral numbers may 

Snt^n 22 characters 0 through 9 only. Hexadecimal numbers may 
contain the characters 0 through 9 and A through F only. Check for 

P, I '° per s ^ c ^ g ° f .these numbers. Blanks can be considered part of a 
numeric field and will cause this error to occur. 


** Message 140, Severity = 2: 

Error while closing a disk file. 

dilk G file USer ReSP ° nSe: Use th e CLOSE command to close the 


** Message 141, Severity = 2: 

The DISPLAY subcommand will abort. 

See Message 031. 
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** Message 142, Severity = 2: 

The LIST subcomitand will abort. 

See Message 031. 


** Message 143, Severity =2: 

A tape drive is not read/ and/or is offline. 

Suggested User Response: Make sure that the tape drive is powered-on, 
a tape has been mounted, and that the online button has been depressed. 


** Message 144, Severity = 
File not found. 


2 : 


Suggested User Response: If you 
rewinding the tape first. If 
subcommand to change the name of 


are working with a tape object, try 
this is a disk object, use the MODIFY 
the specified disk file. 


** Message 145, Severity = 2: 
Specified reoord not found. 


Description: The POSITCN subcommand was 
record number you specified. 


unable to position to the 


Suggested User Response: This may be an 
change the value of the REGORDNO option 
reissue the subcommand. 


acceptable condition. If not, 
with the MODIFY subcommand and 


18.4 

19.0 


** Message 146, Severity = 2: 

A positioning sub-operation 


has aborted. 


Description: An error occurred while a tape was being positioned to 
its correct file and/or reoord location. 


Suggested User Response: Check 
that the correct density is set. 
you reissue the subcommand. If 
indicates that your tape is bad. 


that the correct tape is mounted and 
r ou may try reminding the tape before 
the problan persists, it usually 
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** Message 147, Severity = 2: 

One or more objects are not of type TAPE. 

Suggested User Response: Reissue the subcommand, making sure that at 
least one of the objects you specified is a tape object. For the COPY 

subcommand, all objects must be tape objects. For the POSITION 

subcommand, the one object you specify must be a tape object. For the 

READ subcommand, the first object must be a tape object. For the WRITE 

subcommand, the second object must be a tape object. 


** Message 148, Severity = 2: 

One or more objects are not of type DISK. 

Suggested User Response: Reissue the subcommand, making sure that at 
least one of the objects you specified is a disk object. For the READ 
subcommand, the second object you specify must be a disk object. For 
the WRITE subcommand, the first object you specify must be a disk 
object. 


** Message 149, Severity = 2: 

Error while analyzing the EXCHANGE option. 

See Message 044. 


** Message 150, Severity = 2: 

Invalid operation for a disk or spool object. 

Suggested User Response: Reissue the COPY or POSITION subcommand, 
specifying tape objects only. 


** Message 151, Severity = 2: 

Invalid operation for a tape object. 

Suggested User Response: Reissue the READ or WRITE subcommand with 
disk and tape objects in the correct order. 
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** Message 152, Severity =2: 

An I/O error has occurred in the source object. 

Description: This message may indicate one of the following problems: 

• A tape drive is not assigned. 

• A tape drive is not connected. 

• An invalid command was sent to the tape drive. 

• The source object in the READ, WRITE, or MOVE subcommand you 
just issued was left open due to a previous error# 

• An uncorrectable error occurred while reading a record frcm the 
source object. 


Suaqested User Response: Make sure you have assigned all tape drives 
you 9 plan to use. Make sure that any tape drives you have assigned are 
valid. (If your system contains only one tape drive and 1 
connected to the first controller, that drive can orityte tie ntrfied by 
0 1 2. or 3.) Make sure that the density switches on all drives are 

set correctly. Make sure that all disk files are closed before you 
invote MMX. If the error persists, it may indicate that your tape 

contains bad data. 


18.4 

19.0 


** Message 153, Severity =2: _ 

An I/O error has occurred in a destination object. 

Description: This message may indicate one of the following problems: 

• A tape drive is not assigned. 

• A tape drive is not connected. 

• An invalid command was sent to the tape drive. 

• A destination object in the READ, WRITE, or MOVE subcommand you 
j us t issued was left open due to a previous error. 

• An uncorrectable error occurred while writing a record to a 
destination object. 
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Suggested User Response: Make sure you have assigned all tape drives 
you plan to use. Make sure that any tape drives you have assigned are 
^ alld * Your system contains only one tape drive and it is 
connected to the first controller, that drive can only be identified by 
u, l, 2, or 3.) Make sure that the density switches on all drives are 
set correctly. Make sure that all disk files are closed before vou 

the err ° r Persists ' ifc indlcate ^ % 


** Message 154, Severity = 2: 

Invalid number of files to copy. 

vSif^fof mlTto the ® PY subconl,tBnd specifying a 


** Message 155, Severity = 1: 

A labelled tape is being used in a COPY operation. 


Suggested User Response: This is a warning only 
acceptable message. Mote that it is unacceptable for 
be copied to any location other than the first record 


and may be 
the VCLl label 
on a tape. 


an 

to 


** Message 156, Severity = 2: 

Multiple objects specify the same tape. 

Description: In a COPY or MOVE subcommand two or more objects specify 


Suggested User Response: 
of the TAPE option. Then 


Use the MODIFY subcommand to change the value 
, reissue the MOVE or COPY subcommand. 


** Message 157, Severity = 2: 

Not enough objects have been specified. 


Suggested User Response: Reissue the READ, WRITE, 
subcommand and specify at least two object-names. 


MOVE, or 


COPY 


** Message 158, Severity = 1: 

Up to 8 object-names may be specified. 

Suggested User Response: This is a warning only. You may specify no 

othPr^? 1 ^ ob -J ec t — uames on the MOVE or COPY subcomnand^iSs. Any 
other object-names are ignored. 
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** Message 159, Severity = 2: 

Same object-name appears more than once. 


Suggested User Response: Reissue the READ, WRITE, MOVE, or COPY 

subcommand so that object-names on the subcommand line appear only 

once. 


** Message 160, Severity = 2: 

Tape objects require at least one buffer. 

Description: You have not specified a BUFFERS option for one or more 
tape objects. Since the default value for this option is 0, the READ, 
WRITE, or MDVE subcommand could not be executed. 



** Message 161, Severity = 2: 

Error while analyzing the SEQUENCE option. 

See Message 044. 


** Message 162, Severity =2: 

Error while analyzing the PRINT option. 

See Message 044. 


18.4 

19.0 


** Message 163, Severity = 2: 
Error while chaining tapes. 


Description: You had specified a NEXTCHAIN option value for 
object. However, when it became necessary to change tapes, 
object could not be found. 


a tape 
the next 


Suggested User Response: Use the DECLARE subcommand to declare all 
objects in a chain. Reissue the READ, WRITE, or MDVE subcommand. 



** Message 164, Severity =2: . 

Object-name specified by LIKE option points to sell. 

Description: The name specified as the value for the LIKE option is 
the object-name itself. 

Suggested User Response: Retype the DECLARE or MDDIFY command using a 
different name with the LIKE option. 
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** Message 165, Severity = 2: 

Error while analyzing the LIKE option. 

See Message 044. 


** Message 166, Severity = 2: 

Object-name specified by LIKE option not declared. 


Description: The name 
not previously declared. 


specified as the value for the LIKE option was 


S* 39 ™ 6 User Res P° nse: Re-type the command specifying as a value for 
declared ° ptl ° n the 1131116 of another object that was previously 


** Message 167, Severity = 2: 

The CLOSE subcommand will abort. 

See Message 031. 


** Message 168, Severity = 2: 

Spool options are illegal for non-spool objects. 


Description: You specified a spool option while you were attempting to 
declare or modify a tape or disk object. 


Suggested User Response: Re-type the command 
options for disk objects and tape options for tape 


specifying only disk 
objects. 


** Message 169, Severity = 2: 

Error while analyzing the SPOOL option. 

See Message 044. 


** Message 170, Severity = 2: 

Error while analyzing the FORM option. 

See Message 044. 
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** Message 171, Severity = 2: 

Error while analyzing the AT option. 

See Message 044. 


** Message 172, Severity = 2: 

Error while analyzing the COPIES option. 

See Message 044. 


** Message 173, Severity =2: 

Error while analyzing the CONTROL option. 

See Message 044. 


** Message 174, Severity = 2: 

Error while analyzing the LINENOS option. 

See Message 044. 



** Message 175, Severity = 2: 

Error while analyzing the DEFER option. 

See Message 044 


18.4 

19.0 


** Message 176, Severity =2: 

The SPOOL option value for this object is bad. 


Description: The printing of this error message may indicate an 
internal (severe) MAGNET error condition or a difficulty with the spool 
subsystem. 


Suggested User Response: Attempt to DELETE an objects you were using. 
Then, try to declare these same objects again and re-issue any 
command (s) that you typed prior to receiving this message. If you 
receive this message again or encounter any difficulties while using 
the DELETE and/or DECLARE commands, exit MAGNET and report the problan 
to your System Administrator. 
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18.4 

19.0 


** Message 177, Severity = 2: 

A spool object cannot be an information 


source. 



Description: You typed a MOVE subcommand and specified the source 
object as a spool object. Spool objects can only be used for output. 


Suggested User Response: Re-type the MDVE subcommand, specifying only 
a disk or a tape object as the source. 


** Message 178, Severity = 0: 

QUIT. To exit from MAGNET, use the "QUIT" command. 

Description: You typed CONTRQL-P (the "BREAK" key). This is not an 
error condition, if any operation was in progress, for example a MOVE 
subcommand, it is not restartable. That is, any operation that is 
interrupted must be re-issued again. 

Suggested User Response: Type LIST ITEMS=(OPEN) to obtain a list of 
any object(s) that have been left open. If you were using the old 
(pre-rev 18.4) versions of the READ, WRITE or COPY subcommands, you may 
find "dummy" objects called $DUMMY1 and $DUMMY2. These objects will be 
closed and deleted autetnatically whenever you issue another (old 
version) READ, WRITE, OOPY or position subcommand. These objects 
should be closed, however, (use the CLOSE subcommand) prior to exiting 
from MAGNET. If you interrupted ANY subcommand, you MUST re-issue the 
command again from the beginning; there is NO restart capability. 




** Message 179, Severity = 2: 

Error while analyzing the ITEMS option. 

See Message 044. 



** Message 180, Severity = 2: 

Error while closing a spool file. 

Suggested User Response: This is not usually a severe difficulty 
because, at this point, any information that you wanted to move to the 
spool subsystem has been moved. You can either attempt to use the 
CLOSE subcommand within MAGNET or, after typing QUIT and returning to 
Primos, issue a Primos CLOSE command. 
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** 


Message 181, Severity = 2: 

Error while opening a tape file. 


Description: MAGNET could not open a tape file for any of several 
reasons. Your tape drive may be offline or not ready; an error may 
have occurred in the tape drive, controller or both; the tape may be 
bad and MAGNET could not read from or write to the tape even after ten 
attempts; the end-of-tape marker may have been detected; the 
specified FILEID option does not match the file identification fields 
of any HDR1 labels; the file number specified by the FILENO option is 
larger than the number of files on the tape. 

Suggested User Response: Check the FILEID option value for correct 
letters, symbols and case. Try specifying a PREACTION= (REWIND) option 
in a MODIFY command. Re-issue the READ, WRITE or MOVE subcommand. 


** Message 182, Severity = 2: 

Error while opening a spool file. 

See Message 137. 


** 


Message 183, Severity = 2: 

Error while closing a tape file. 


Description: You may receive this message for any one of several 
reasons. The tape drive may have gone offline or become not ready; 
the end-of-tape marker may have been detected; an error may have 
occurred in the tape drive, controller or both; the tape may have a 
bad spot and MAGNET could not read from or write to the tape even after 
10 attempts. 


18.4 

19.0 


Suggested User Response: This is usually a severe problem. It may be 
necessary to rewind the tape and re-issue your WRITE or MOVE command. 
If, after re-writing to the tape you receive the same message and you 
notice that the tape has not reached the EOT marker, the tape probably 
contains a bad spot. If you had been reading or moving from the tape, 
this problem can be rectified by issuing a CLOSE command. 



** Message 184, Severity 2: 

Error while reading from a tape file. 

Description: This message usually indicates a bad spot on the tape. 

Suggested User Response: Retry the READ or MOVE operation. If the 
error message persists, the tape is bad and cannot be read. 
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** Message 185, Severity = 2: 

Error while writing to a tape file. 

Description: This message usually indicates a bad 



spot on the tape. 


Suggested User Response: Retry the WRITE or MOVE operation. If the 
error message persists, the tape is bad and cannot be read. 


** Message 186, Severity = 2: 

Error while writing to a disk file. 


Description: This message may indicate a number of problans: a full 
disk or a FAM or network difficulty. 


Suggested User Response: Exit MAGNET, and check for a 
that is not the problem and you are attanpting to access 
through the FAM, check that the FAM is running and that 
a network are also running. 


full disk. If 
a disk file 
all systems on 


18.4 

19.0 


** Message 187, Severity = 2: 

Error while writing to a spool file. 

See Message 186. 



** Message 188, Severity = 0: 

Operation complete. 

Description: This message indicates that an I/O operation (READ, WRITE 
POSITION, COPY or MOVE has successfully completed. 


** Message 189, Severity = 0: 
n Physical blocks read. 

Description: This message should always be preceeded by message 188. 
"n" indicates the number of physical blocks read from a tape file. 


** Message 190, Severity = 0: 
n Logical records read. 

Description: This message should always be preceeded by message 188. 
"n" indicates the number of logical records read from a tape or disk 
file. 
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** Message 191, Severity = 0: 
n Physical blocks written. 

Description: This message should always be preceeded by message 188. 
"n" is the number of physical blocks written to a tape. 


** Message 192, Severity = 0: 
n Logical records written. 

Description: This message should always be preceeded by message 188. 
"n" is the number of logical records written to a tape or disk file. 


18.4 

19.0 


**Message 193, Severity = 2: 

Error while analyzing the MODE option. 

See message 044. 


♦♦Message 194, Severity = 2: 

Error while analyzing the PAD option. 

See message 044. 
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8 

The MAGSAV 
and MAGRST 
Subsystems 


INTRODUCTION 

MAGSAV and MAGRST are PRIMDS subsystems that move files from any disk 
including storage modules to a seven— or nine—track magnetic tape and 
vice versa. The files are moved logically, and may be SAM, DAM, 
segment directories, UFDs, MFDs, disks, or partitions. Whenever you 
specify a directory, the directory and all of its components (the 
subtree) are transferred. Because of their wide capabilities, MAGSAV 
and MAGRST can be used by both operators and other system users. 


TOE MAGSAV SUBSYSTEM 

MAGSAV is the PRIMDS disk-to-tape backup subsystem. It allows you to 
copy files and directories from any PRIMDS—supported disks and disk 
partitions onto seven- or nine-track magnetic tape. 


Backups and Archiving 

MAGSAV serves two types of users: 

• The user who wants to archive files or directories (or who wants 
to transport a file from one Prime system to another). 

• The operator or administrator who needs to do system backups. 
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18.4 

19.0 


For the operator, it offers two types of backups: 

;> 

• Full backups, which copy entire UFDs or MFDs (disk partitions) 
onto tape. 

• Incremental backups, which copy only files or directories 
modified since the last backup. 

By alternating full and incroriental backups, the operator can keep 
up-to-date copies of all files with a saving of time and tapes. To do 
this, use MAGSAV 1 s -UPDT and -INC options, as follows: 

1. Start with a full backup, using the -UPDT option. When MAGSAV 
has finished this, save. All files will have their DUMPED bits 
set to 1, as a signal that they have been saved. 

2. As users continue to use the system, they will add new files 
and modify old ones. Every file that is added or modified has 
its DUMPED bit set to 0, as a sign that it has not been saved 
in its current form. 

3. Now an incremental backup may be done, using both the -INC and 
-UPDT options. (You may also use -SUFD, if you wish.) The 
-INC option causes MAGSAV to check the DUMPED bit on each file 
before saving it. Only if the DUMPED bit is 0 will the file be 
saved. (For example: If a full save with the -UPDT option 
were done on Monday, and an incremental save were done on 
Thursday, only files created or modified between the save on 
Monday and the save on Thursday would be written onto 
Thursday's tape.) Once the file is saved on tape, the -UPDT 
option causes MAGSAV -to set its DUMPED bit to 1. Therefore, at 
the end of this save, all files again have the DUMPED bits of 
1 . 

If the -9JFD option is not used on an incranental save, only 
altered files are saved. When restored, these files must be 
copied into an existing directory having the same name as the 
directory from which they were backed up. If -SUFD is used, a 
skeleton directory structure is saved along with the altered 
files. This allows the files to be restored either into an 
existing directory or onto a blank disk. 


Caution 

Users who are archiving their own files or directories will 
probably not want to use the -UPDT or -INC options, as this may 
prevent their files from being saved during system backups. 
Only users who know that MAGSAV is never used for system 
backups on their system should use the -UPDT or -INC options to 
MAGSAV. 
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-SAVE_UFD 

-SUFD 


Tells MAGSAV always to save directories, whether or not 
they have been modified. This option is only used with 
the -INC option. 


If the -SUFD option is not used on an incremental save, 
only altered files are saved. When restored, these 
files must be copied into an existing directory having 
the same name as the directory from which they were 
backed up. If -SUFD is used, a skeleton directory 
structure is saved along with the altered files. This 
allows the files to be restored either into an existing 
directory or onto a blank disk. 
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Running MAGSAV 

There are 5 steps to running MAGSAV: 

1. ASSIGN a tape drive and mount your tape (or have the operator 
mount it for you). (The ASSIGN command is explained in Chapter 
4.) 

2. Invoke MAGSAV, as explained below. 

3. Tell MAGSAV what you want saved, by responding to its prompts 
(as explained below, in The MAGSAV Dialog ). 

4. Allow MAGSAV to write the tapes, mounting additional tapes if 
MAGSAV asks for them. 

5. Remove the tapes, and UNASSIGN the tape drive. 


Invoking MAGSAV 

The command line format for invoking MAGSAV is: 
MAGSAV [options] 


Command Line Options: You may specify one or more options in any order 
on the MAGSAV command line. These options and their functions are: 


Option Result 

-7TRK Specifies seven-track tape format. The default is 

nine-track. 

-LONG Specifies a 1024-word record size. The default is 

2048-word variable length records. 

-P300 Specifies 512^word records. Also suppresses ACLs. 

-VAR Writes variable-length records up to 2048 words. (This 
option is the default.) -VAR is useful for large files, 
since it decreases the amount of tape used for record 
headers. 

-UPDT Specifies an update. The DUMPED switch in the UFD entry 
will be set for files and directories that are saved frcm 
disk onto tape. If you do not specify this option, the 
DUMPED switch is not set. 
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-INC Specifies an incremental dump. Only files and 
directories with a reset (=0) DUMPED switch are saved. 
If you do not specify -INC, all files and directories are 
saved. 

-SAVEJUFD Tells MAGSAV always to save directories, whether or not 
-9JFD they have been modified. This option is only used with 
the -INC option. 

“TTY Takes the tape unit number from your terminal. All other 
information is taken from the current input stream. You 
use this option with Q?L files and command input files. 

-N0_ACL Specifies that MAGSAV is not to save any ACL's or ACL 

-NOA references. Tapes saved with the -ND_ACL option can be 

restored by Rev. 18 MAGRST onto a Rev. 18 system. 

If this option is not specified, ACL information is saved 
to tape, as explained below. 


The MAGSAV Dialog ; After you invoke MAGSAV and specify any options on 
the command line, the MAGSAV dialog begins. MAGSAV requests 
information from you in the following order. Appropriate user 
responses are shown. 


Request 


Response 


TAPE UNIT: 


Supply the physical or logical tape unit 
number (0-7). 


Note 

When MAGSAV encounters the physical 
END OF TAPE (EOT), a message appears 
on your terminal and a new tape unit 
is requested. The new unit may be 
the same as the old unit. 


ENTER LOGICAL 
TAPE NUMBER: 


TAPE NAME: 


Supply 1 for the first logical tape, 2 for 
the second, and so on. MAGSAV rewinds the 
tape, then positions it correctly. If you 
enter the value 0, MAGSAV assumes that your 
tape is already positioned correctly. 

Supply any name, no more than six characters 
long. 


k 
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DATE: Supply the date in the format MM DD YY. 

PRIMDS checks the date and rejects it if it 
is not valid. If you reply to this request 
with a carriage return (CR), the current date 
is used. (This is the default.) 

REV. HO: Supply any number. 

NAME OR COMMAND: Supply the name of a file or directory you 

wish to save, or supply an action command. 

A filename identifies the specific file or 
directory you wish to save on tape. If you 
specify an MFD, you are identifying an entire 
disk to be saved. (You must be attached to 
the specified MFD.) If you specify an 
asterisk (*) you wish to save your current 
directory. If MAGSAV encounters an access 
problem during a save operation, then that 
file is abandoned, and MAGSAV continues with 
the next f ile/UFD (if there is one). 

Possible action command responses are: 

$A ufd [password] [ldisk] [key] — Changes 
the home UFD. If you do not specify ldisk , 
cxily the local disk is searched for the 
specified UFD. This is the default. $A does 
not accept pathnames. 

$1 [filename] n — Prints, at your terminal, 
an index of files and directories saved from 
disk to tape. This is the default. If you 
specify a filename , the index is written into 
that file. n indicates the number of levels 
to be included in the index. (The default is 
two levels.) $1 does not accept pathnames. 

$Q — Terminates the logical tape and returns 
you to PRIMDS. 

$R — Terminates the logical tape, rewinds 
the physical tape, and returns you to PRIMDS. 

$UPDT ON — Turns on update and sets the 
DUMPED switch for all saved files and 
directories. This action command is the same 
as the -UPDT command line option. 

$UFDT OFF — Turns off update and does not 
set the DUMPED switch for saved files and 
directories. This is the default. 
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$INC ON — Turns on incranented dump and 
saves only those files and directories with a 
set DUMPED switch. This action command is 
the same as the -INC command line option. 


$INC OFF — Turns off incremented dump and 
saves files and directories whether or not 
their DUMPED switch is set. This is the 
default. 


Sample MAGSAV Session : The following example illustrates a terminal 
session during which a disk file, DFILE, was saved on tape. If a 
carriage return (CR) is given in response to the DATE and REV NO 
prompts as shown below, the system supplies the current date and zero 
Rev number. Note that, as in this example, you can supply a logical 
device number (ldn) as a response to the TAPE UNIT prompt. You can 
also supply either a pdn or an ldn (if one has been assigned). 


OK, AS MT1 -ALIAS WT 7 
Device MTl Assigned. 
OK, STAT DEV 


DEVICE USRNAM USRNUM LDEVICE 
MTl ADLEY 50 MT7 


OK, MAGSAV 
REV. 19.0 

TAPE UNIT (9 TRK): 7 
ENTER LOGICAL TAPE NUMBER: 
TAPE NAME: DATATAP 
DATE (MM DD YY): (CR) 

REV NO: (CR) 

NAME OR COMMAND: DFILE 
NAME OR COMMAND: $Q 
OK, 


0 




How MAGSAV Handles ACLs 


19.0 


A file or directory using ACL protection can be protected in one of 
three ways: it can be protected by a specific ACL; it can be 
protected by a category ACL; or it can use the default protection of 
the directory in which it resides. 


Specific ACLs : Specific ACLs are always saved (unless the user gives 
the -ND_ACL option). Specific ACLs are saved immediately after the 
objects they protect. 
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Category ACLs: If a UFD is saved, all category ACLs within the UFD are 
saved. They are written onto the tape before any other files or 
directories. Each object protected by a category ACL is followed on 
the tape by the information that it is so protected. 

If individual files are being saved by name, then any desired category 
ACLs must also be saved by name. They are not saved automatically, as 
specific ACLs are. 

Default Protection: No ACL information is saved for file system 
objects that use default protection. 


How MAGSAV Handles Quotas 

MAGSAV saves quotas when it saves a UFD. 


THE MAGRST SUBSYSTEM 

MAGRST allows you to restore information from a magnetic tape created 
by MAGSAV cxi any Prime-supported disk(s). This information is saved 
from and readily restored into the PRIMUS file syston. All restore 
operations take place in your home UFD. MAGRST can read tapes of any 
record size, with fixed- or variable-length records (up to 2048 words), 
making it compatible with MAGSAV. 


Running MAGRST 

The MAGRST command line format is as follows: 

MAGRST [options] 

Type MAGRST after the PRIMUS prompt (OK,). At this point, there are 
several command line options you can specify. After you give options 
(if any) on the oomirand line, MAGRST responds with a series of 
questions. The MAGRST dialog (questions and appropriate user replies) 
are discussed following the command line options. 


Command Line Options: You may specify one or more options in any order 
on the MAGRST command line. These options and their functions are: 

-7TRK Specifies seven-track format. The default is 
nine-track. 
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-TTY 


Takes the tape unit number from your terminal. Ml 
other information is taken from the current input 
stream. You use this option with CPL files and command 
input files. 


Note 


There is no option that restores a tape without restoring the 
ACL information saved on the tape. 


The MAGRST Dialog : After you invoke MAGRST and specify any options on 
the command line, the MAGRST dialog begins. MAGRST requests 
information from you in the following order. Appropriate user 
responses are shown. 


Request Response 

TAPE UNIT: Supply a physical or logical device number 

(0-7). If you do not specify the -7TRK 
option on the MAGRST command line, the 
default is nine-track. 


Note 


When MAGRST encounters the physical 
END OF TAPE (EOT), a message appears 
on your terminal and a new tape unit 
is requested. The new unit may be 
the same as the old unit. 


ENTER LOGICAL 
TAPE NUMBER: 


Supply a logical tape number from 1 to n (1 
for the first logical tape, 2 for the second, 
and so on), if your tape is divided into 
several logical units. This positions your 
tape to the specified logical tape. If you 
enter the value 0, MAGRST assumes that your 
tape is alreafy positioned correctly. 
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NAME: 

DATE: 

REV. 

REEL 

READY 


1 


Note 

A "runaway" tape condition can occur 
if there is only one logical tape on 
the currently mounted reel and you 
supply a number greater than 1 in 
response to this request. If this 
happens, MAGRST searches endlessly 
for the nonexistent logical tape(s) 
and is not able to read the EOT 
(end-of-tape) marker. You must 
unassign your drive to abort the 
unsuccessful search. 


MAGRST does not have to search all logical 
tapes when it restores sequential ones. 
After MAGRST returns you to PRIMOS, the tape 
is not rewound. Instead, it is positioned at 
the location before the beginning of the next 
logical tape in sequence. For sequential 
logical tapes, run MAGRST again and supply 0 
as the response to the LOGICAL TAPE NO: 
request. Then, the next logical tape is 
restored without rewinding and reading 
through the preceding logical tapes. 

No user response is necessary. MAGRST 
displays the name of the logical tape at 
which you are currently positioned. This is 
the name provided during the MAGSAV dialog. 

No user response is necessary. MAGRST 
displays the date that the tape was recorded. 
This is the date provided during the MAGSAV 
dialog. 

NO. NO user response is necessary. MAGRST 
displays the number provided during MAGSAV. 

NO: No user response is necessary. MAGRST 
displays the appropriate tape reel number. 

TO RESTORE: Supply one of the following options: 

YES — Restores the entire tape and returns 
you to PRIMOS. If MAGRST encounters an 
access problem during a restore operation, 
then that file is abandoned and MAGRST 
continues with the next file/UFD (if there is 
one). 


8-9 


First Edition, Update 2 






UFD5027-190 





W (V&/\ | L*OK^t* 


TREE NAME: 

. . . 


NO — Requests a different tape unit and 
logical tape. (MAGRST does not restore the 
previously specified tape.) 

$1 [filename] n — Prints, at your terminal, 
an index of all files and directories 
restored. -This — is — the — default. If you 
specify a filename, the index is written into 
that file. n indicates the number of levels 
to be included in the index. (The default is 
two levels.) $1 does not accept pathnames. 

NW [filename] n — Prints, at your terminal, 
a tape index, but files and directories are 
not restored. If you specify a filename , the 
index is written into that file, n indicates 
the number of levels to be included in the 
index. (The default value is 100.) This 
option is useful if you wish to determine the 
tape's contents. NW does not accept 
pathnames. 

$A UFD [password] [ldisk] [key] — Attaches 
you to the specified UFD. Pathnames are not 
allowed. Supply a password , if needed. If 
you do not specify a number for ldisk , MAGRST 
searches all disks for the specified UFD. 
(The STATUS DISK command gives ldisk 
numbers.) Supply a numerical value for key 
to attach to a sub-UFD. If you wish to 
attach to a sub-UFD in the current UFD, then 
set ldisk equal to 0 and key to 2. 

PARTIAL — Restores only certain files and 
directories. Supply pathnames in response to 
the TREE NAME: request. 

This request prints only if you supply the 
PARTIAL option. In response to TREE NAME:, 
supply the pathname of the file or directory 
you wish to restore. In the pathname, do not 
include the name of the UFD from which the 
file or directory was saved. You may specify 
multiple pathnames for a partial restore. In 
this case, the TREE NAME: request is 
repeated after, each restoration until you 
enter a null line (CR), which signals the end 
of restoration. For a partial or full 
restore, files with bad records are omitted. 
The pathnames of these files are printed, 
along with an error message. A maximum of 
ten treenames per restore is permitted. 
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After each file or directory is restored, the 
message FILE COMPLETE prints at your 
teminal. The message RESTORE COMPLETE 
prints when the end of logical tape is 
reached. 


Sample MAGRST Session : The following example illustrates a terminal 
session during which a file is restored from tape to disk. The file 
(DFILE) saved in the previous MAGSAV sample session is also used in 
this example. 


OK, MAGRST 
REV. 19.0 

YOU ARE NOT ATTACHED TO AN MFD 
TAPE UNIT (9 TRK) 

ENTER LOGICAL TAPE NUMBER: 1 

NAME: DATATAP 

DATE(MM DD YY): 09-02-81 

REV NO: 0 

REEL NO: 1 

READY TO RESTORE: PARTIAL 

TREE NAME: DFILE 

TREE NAME:( CR) 

*** STARTING RESTORE *** 

*** END LOGICAL TAPE *** 

*** RESTORE COMPLETE *** 

OK, 


How MAGRST Handles Protection 


At Rev. 19, users can choose between ACL and password protection for 
their directories. MAGRST can handle both types of protection. 


The general rule under which MAGRST works is this: if there is a 
conflict in a matter of protection between an object being restored 
from tape and an object of the same name resident on the disk, the 
protection on the disk is retained. The reason for this is that the 
version on the disk will probably be the more recent one, and thus is 
more likely to reflect the owner's current wishes. 


19.0 
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19.0 


ACL vs. Password UFDs: Whenever possible, MAGRST restores ACL UFDs as 
ACL UFDs and password UFDs as password UFDs. However, if a UFD 
currently on the disk has the same name, (but a different type), frcin a 
UFD being restored from tape, the type of the UFD on the disk will be 
maintained. For example, if an ACL UFD STATS is being restored frctn 
tape, but a password UFD STATS already exists on the disk, the UFD 
STATS will be restored as a password UFD. Similarly, if the password 
UFD ACCTS is restored into an ACL UFD ACCTS, it is restored as an ACL 
UFD, with all files and subdirectories taking on the default protection 
of the existing UFD. 

If the tape was saved with the -ND_ACL option, then the UFDs will be 
restored as the same type (ACL or password) as the parent directory. 


Caution 

If MAGRST is running under PRIMUS II, all UFDs are restored as 
password UFDs. 


How MAGRST Handles ACLs: MAGRST always tries to restore the ACL 
protection - savecTbiTMAGSAV. The following exceptions exist: 

• If an object being restored already exists on the disk, the 
protection on the disk is retained, and the protection on the 
tape is ignored. 

• A category ACL is restored only if no category ACL of that name 

exists on the disk. (If a category ACL of the same name does 

exist, the user will be warned of that fact.) 

• if a file protected by a category ACL has been saved by name or 
is restored fcy name, the category ACL is not restored. (In the 
former case, the category ACL may not even be on the tape.) If 
the category ACL already exists on the disk, then the object 
will be protected by that ACL. Otherwise, the object will 
receive default protection, and an error message will be 
printed. 

Therefore, if you wish to restore specific files, together with 
their category ACLs, you should first restore the category ACLs, 
and then restore the protected files. 

Note 

MA3SAV writes ACL information to the tape after it writes the 
object itself. Therefore, MAGRST restores hCL information to 
disk after it restores the object to disk. It writes the 
object (including all its subentries), then sets the access. 

This means that a user who has no rights to an object can 
restore the object frcm tape with MAGRST, but may not be able 
to use it once it is restored. 
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How MAGRST Hand les Qu otas 

Quotas will be restored if the corresponding UFD does not already exist 
on the disk. If the UFD does exist, its existing quota will remain in 
effect. 


MAGSAV AND MAGRST MESSAGES 

Messages you get from MAGSAV and MAGRST are either informational or 
error-related. The messages for both subsystems appear here as a 
group. They are listed alphabetically and identified as being 
generated by MAGSAV or MAGRST (or both). An explanation is also 
provided for each message. 


• ***** DISK IS EULL ***** 

use 'delete' command to delete unnecessary files. 

Type 's' to continue. (MAGRST) 

MAGRST: The partition to which you are restoring is full and MAGRST 
cannot continue until you delete sane files. 


• ***** Quota exceeded ***** 

use 'delete' command to delete unnecessary files. 

Type 's' to continue. (MAGRST) 

MAGRST: The disk quota for a UFD somewhere within the current tree is 
exceeded. After printing the error message, MAGRST exits to command 
level. You may use any internal commands to clear enough space to 
continue the restore, then type 's' to restart MAGRST. 


• ***start of Reel x *** 

MAGSAV: A new reel has been started. 


19.0 


• ***WARNING*** 

Unable to recover to beginning 
Restarting at name: name 

If you continue, you will have to keep the reel which failed. 

MAGSAV: An unrecovered error has occurred and MAGSAV is unable to 
recover to the beginning of the tape, so it will recover frcm name . 
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• *****WARNING — REEL NUMBER NOT IN SEQUENCE 
CONTINUE WITH THIS REEL (Y OR N) ? 

MAGRST: You mounted a tape during MAGRST that is not the next reel. 
You may continue by typing Y, or allow mounting a new tape by typing N. 


19.0 


• ACL could not be read: error message 
ACL omitted on: name 

MAGSAV: MAGSAV was unable to read the ACL protecting name . The object 
will be saved with default protection. 


• BAD ATTACH: 

NEXT COMMAND MUST BE AN ATTACH 

MAGSAV and MAGRST: An attempt to illegally use $A. MAGSAV/MAGRST will 
not continue until a correct $A is performed. 


• BAD ATTACH ON: 

OMITTING TREE-PATH: 

MAGRST: The subsystem was unable to attach to a UFD while restoring 
it. Subordinate files and UFDs cannot be restored. 


• BAD FILETYFE FROM TAPE: 

MAGRST: A treename block containing an illegal file/UFD type has been 
read from tape. MAGRST will abort. 


• BAD LABEL RECORD ID 

MAGRST: A new reel has been mounted, but the first record is not a 
MAGSAV label. MAGRST allows a new tape to be loaded. 


• Can't open Index file 


19.0 


MAGSAV and MAGRST: The file you wanted opened for the index cannot be 
opened. The user will be prompted for "Name or Command" (MAGSAV) or 
"Ready to Restore": (MAGRST) 


First Edition, Update 2 


8-14 










MAGSAV AND MAGRST 


• Category ACL already exists: name omitted. 

MAGRST: The access category name on the tape was not restored because 
it already existed on the disk. If you want to restore the category 
from the tape, you will have to delete the one currently on the disk. 


19.0 


• COULDN'T READ FIRST RECORD 

MAGRST: The first record on your tape could not be read. Try a new 
tape. 


• COULDN'T READ UFD RECORD 

MAGRST: A UFD record on your tape could not be read. The UFD and its 
subordinate files cannot be restored. 


• DUE TO BAD TAPE ADDITIONAL TAPE MARKS WERE ADDED TO THE END 

LOGICAL TAPE. DO NOT APPEND OTHER MAGSAV LOGICAL TAPES TO THIS 
REEL* 

MAGSAV: A tape error occurred while a tape mark was being written. 


• EMPTY DISK! 

MAGSAV: The subsystem is operating on an empty disk. Command dialog 
will allow you to attach somewhere else. 


• ERROR ACCESSING FILE > 

MAGRST: The subsystem could not open or create the requested file. 
The file is ignored. 


• Error creating Category ACL: message 
Category ACL emitted: name 


MAGRST: The access category name could not be created due to seme 
error (explained by message). The category will be omitted. Note that 
this will cause further error messages, "Error using Category ACL", for 
objects that were protected by this category. 


19.0 
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• Error reading Category ACL: message 
Category ACL omitted: name 

MAGSAV: MAGSAV encountered a unexpected error attempting to read the 
contents of access category name . The access category data are 
omitted. 


• Error reading DISK QUOTA : message 
QUOTA omitted on: name 

MAGSAV: MAGSAV encountered an unexpected error (explained by message) 
while reading the disk quota on the UFD name. The UFD is saved as - a 
non_quota UFD. 


• ERROR READING TAPE LABEL 

MAGRST: The subsystem cannot read the tape label. It may not be a 
MAGSAV tape. Try another tape. 


• Error - ranoving BOLT 

Do extra saves on new tape 

MAGSAV: When the $A command is given r an end of logical tape (EGLT) 
marker is written in case there is an error in the $A command. If an 
error occurs when an attempt has been made to remove the BOLT, this 
message is sent to the user and the subsystem aborts. 


• Error setting SEGDIR size "error " -CN: " name " 
MAGRST: An error was found in SEGDIR. It is ignored. 


• Error setting specific ACL: message 
ACL emitted: name 

MAGRST: The specific protection could not be set on object name. The 
object will be default protected. 
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• Error using Category ACL "aclname ": message 
ACL emitted on: name 


MAGRST: Object name should be protected by category aclname, tut the 
category does not exist. This can happen when the object was saved by 
name, or when it is being restored ty name (using MAGRST 1 s PARTIAL 
command). The object will be default protected. 


19.0 


• Error writing file: message 
File truncated: name 

MAGRST: MAGRST encountered an unexpected error writing the data file 
name. The file is truncated. 


• FILE IN USE 


MAGSAV and MAGRST: A file alreacfy in use ty other users is either 
being saved or restored. It is ignored. 


• FILE PROTECTED 

MAGSAV and MAGRST: A file cannot be saved or restored because it is 
protected. The file is ignored. 


• FILETYPE MISMATCH 

MAGRST: The subsystem is attempting to restore an object from tape 
which has the same name, (but a different type), as an object on the 
disk. The file is ignored. 


• Index truncated and closed 

MAGSAV and MAGRST: An error has occurred while writing the index. 


19.0 


• INVALID COMMAND 

MAGSAV and MAGRST: You typed a command that the subsystem could not 
recognize. 
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• INVALID RECID: 

MAGRST: An invalid record was encountered. 



The subsystem will abort. 


19.0 


• Label written after xx retries 

MAGSAV: Warning message only. Problem writing tape label. 


• MAGSAV UNABLE TO CONTINUE 

MAGSAV: The subsystem cannot 
the PRIMUS error message plus 


find a UFD in a pathname, 
this message and exits. 


MAGSAV prints 



• MT IS OFFLINE OR NOT READY 

MAGSAV and MAGRST: The tape drive you requested is offline or not 
ready. Fix the drive and continue with your save or restore operation. 


NO END LOGICAL TAPE RECORD1! 


MAGRST: The subsystem encountered the end of a physical tape, but it 
did not encounter an end-logical-tape record or an end-of-reel record. 
It assumes an end-of-logical tape. 


19.0 


• Not an ACL UFD 

MAGRST: Since the current UFD is passworded, the object referred to in 
the message could not be properly restored. This message is normally 
accompanied by other messages which further explain the specific error. 


• Object already existed. ACL reference: name omitted. 

MAGRST: MAGRST will not overwrite ACL protection on objects it did not 
create. The protection of the object remains unchanged. 
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• Object to set ACL on does not exist: name - ACL emitted. 

MAGRST: MAGRST has found a data block containing ACL information for 
object name, but the object itself does not exist. The ACL data block 
is ignored. 


19.0 


• Old partitions are not supported 

MAGSAV: The partition is a pre-Rev. 12 partition. The subsystem 
aborts. 


• PRE-REV. 12 TAPE 

MAGRST: The subsystem is restoring a pre-Rev. 12 tape. 


• Pre-Rev 19 tape 

MAGRST: The subsystem is restoring a pre-Rev. 19 tape. 

• Prob opening current ufd 

MAGSAV: The current ufd cannot be opened, type S to try again. 


19.0 


• PROB OPENING CURRENT UFD: (error information) 

ATTACH AND TYPE 'S' 

MAGSAV and MAGRST: The UFD you are currently attached to is causing a 
problem. Try to attach again. 


• RECOVERED MT 10 ERRORS 

MAGSAV and MAGRST: This specifies the number of magnetic tape errors 
during a save or restore operation, which were overoome. This is 
useful for checking the condition of the tapes you are using. 


• Restarting current reel (Reel x) 

MAGSAV: An unreoovered error has occurred and current reel is being 
restarted. 


19.0 
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• RESTORE ABORTED ON: 

MAGRST: The subsystem aborted due to an unrecoverable tape read error. 


• Restoring ACL UFD as Password UFD: name 

MAGRST: The UFD on the tape is an ACL UFD, but the tape is being 
restored under PRIMOS II. Since PRIM3S II cannot handle it, the UFD is 
restored as a password UFD. ACL protection on restored objects will be 
lost. (This may create more warning messages.) 


• Restoring ACL UFD into existing Password UFD: name 

MAGRST: The object on the tape is an ACL UFD, but the one on the disk 
is a password UFD. ACL protection on restored objects will be lost. 
This message will normally be followed by other warning messages 
concerning lost protection. 


• Restoring Password UFD into existing ACL UFD: name 

MAGRST: The UFD on the tape is a password UFD, but the one on the disk 
is an ACL UFD. The objects restored into the UFD will all be default 
protected. 


• Rev 19 tape without ACLs 

MAGRST: The subsystem is restoring a tape made with the -NO_ACL option 
Of MAGSAV. 


• -SAVE_UFD may only be used with -INC 

MAGSAV: -SAVEJUFD has been given in the command line without the -INC 
command. The subsystem will abort. 

• TAPE NOT AT LOAD POINT 

MAGRST: Your tape is not positioned to the beginning of tape. 
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• TAPEOF — MT STATUS ERROR 

MAGSAV: The subsystem encountered an error while writing a tape 
marker. 


• Token name is not a command option 
or 

Unsupported option name 

MAGSAV: The user has specified an incorrect option on the command 
line. The subsystem will inform the user which options are available 
and then abort. 


• 'TOO MANY LEVELS' treename 

MAGSAV: The subsystem can only save up to 18 levels on PRIMOS, 13 on 
PRIMOS II. If more levels are attempted, MAGSAV prints this message, 
ignores the file, returns to the previous level, and saves the files at 
that level while continuing back up the tree in the same manner. 


• TOO MANY NAMES — START INS RESTORE 

MAGRST: The subsystem has filled its name table for a partial restore. 
(Maximum = 10.) The restore will still begin. 


• Unable to set QUOTA: error message 
QUOTA omitted on: name 

MAGRST: MAGRST was unable to set the disk quota on the UFD name which 
it had just created. The UFD is restored as a non-quota UFD. 


• UNABLE TO WRITE LABEL. MOUNT NEW TAPE. 

MAGSAV: The subsystem cannot write a label on this tape. Obtain 
another tape. 


• UNEXPECTED EOF ENCOUNTERED ASSUMING 
END OF REEL 

MAGRST: The subsystem encountered the end of the tape reel. You can 
mount a new reel. 
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Unknown non-default ACL type. 
ACL omitted on: name 


19.0 


MAGSAV: The entry for name indicated that the object was not default 
protected, but AC$LST returned a protection type that indicated neither 
"specific" nor "category" protection. The object is saved as default 
protected. 


• WARNING-SAVING FILE OR SUB-UFD CALLED MFD 

MAGSAV: This is only a warning. Your save operation will continue 
successfully. 


19.0 


• Wrong Tape. 


MAGRST: A new reel with a name different from the previous reel has 
been loaded and read. MAGRST allows a new tape to be loaded. 


• YOU ARE NOT ATTACHED TO AN MFD 


MAGSAV: This is only a warning, 
successfully. 


Your save operation will continue 



First Edition, Update 2 


8-22 









9 

The PHYSAV 
and PH YRST 
Subsystems 


INTRODUCTION 

PHYSAV and PHYRST are PRIMUS subsystems that create a disk image backup 
on magnetic tape and restore that image back to disk frcm tape. Both 
subsystems support the following hardware: 

• Nine-track magnetic tape 

• 40MB, 80MB, 160MB, 300MB, and 600MB storage module disks 

• 32MB, 64MB, and 96MB cartridge module disks 

Although PHYSAV and PHYRST are usually used solely by the system 
operator, both subsystems can be used by all other users as well. 


THE PHYSAV SUBSYSTEM 

PHYSAV copies the contents of one or more disk partitions to magnetic 
tape in physical track order. To minimize disk read time, all tracks 
(of all partitions) on one disk cylinder are written to tape, before 
moving the disk heads to the next cylinder. 

Each disk track is written as two magnetic tape blocks of 5212 and 4170 
words. 
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Since no attention is paid to logical file structure, it is not 
possible to restore a single file. The smallest unit which can be 
restored is a partition (as defined to the PHYSAV utility). 

PHYSAV runs in V-mode under FRIMDS only. 

After PHYSAV successfully writes the header of each tape section, it 
informs you with a message identifying the reel, the logical tape, and 
the corresponding section. A new section begins with 1 for the 
beginning of a logical tape, and is incremented by 1 each time a new 
physical magnetic tape reel is started. 


Specifying Disk Partitions to PHYSAV 

PHYSAV can save one or more partitions in a single logical tape. (A 
logical tape may be part of a physical tape; or, it may contain 
several reels of tape.) All partitions to be saved on one logical tape 
must be on the same controller and unit. 

PHYSAV needs to know the physical device number of the partition to be 
saved. You can find this number with the STATUS DISKS command. For 
example: 

OK, STAT PI 

Disk Ldev Pdev Systsn 
FOREST 0 4463 

OCEAN 1 460 

CLOUDS 2 31460 

DESERT 3 60460 

CITY 4 71060 

If you wanted to save the partition "FOREST", you would give PHYSAV the 
physical device number 4463. 


Notes 

1. You can save several partitions at once with PHYSAV. 
However, doing so requires that you compute the new 
physical device number for the combined partition. It also 
prevents use of the RAT, and hence prevents disk 
compression and badspot handling. 

Information on how to do this type of save is given in the 
System Operator's Guide . 

2. The operator can use PHYSAV to save the comrrand partition. 
The technique for doing this is explained in the System 
Operator's Guide . 
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Using the RAT 

You can perform a more efficient save by using the Record Availability 
Table (RAT) of the partition you are saving. When the RAT is used, 
PHYSAV copies only those tracks which contain records currently in use 
by the file system. 

The one drawback to using the RAT is that information can be lost if 
the RAT is not correct. To guard against this, the operator can run 
FIX_DISK before running PHYSAV. 


Using FIX_DISK 

It is usually a good idea to run FIX_DISK on a partition before saving 
it. This ensures that the partition's Record Availability Table is 
correct. It is particularly important that the RAT is correct if: 

• You want to use the RAT in the save. 

• You want to be able to do badspot handling (on Rev. 19 disks) 
when the partition is restored. 

On a Rev. 19 disk, running FIXJDISK also takes care of any remapping 
of records caused by previous badspot handling, and thus ensures that 
the BADSPT file will not contain an EQUIVALENCE block. If an 
EQUIVALENCE block is present when the save is done, PHYRST will not be 
able to restore the partition. 


Invoking PHYSAV 

The PHYSAV command line format is as follows: 

PHYSAV [-TTY] [-LOWEND] [-UNMDD] 

Use the -TTY option if you wish PHYSAV to ask for the magnetic tape 
unit number at the terminal, even if it is running from a CPL or 
COMINPUT file. Do not use the -TTY option if you are planning to run 
the command file as a Batch job or phantan, or if you want PHYSAV to 
take the magnetic tape unit number from the command file. 

Use the -LCWEND option if you are using a machine other than a Prime 
750 or 850. 

Use the -UNMDD command line option only if you are using one of the 
following old controllers: wire wrap disk controller boards without 
ECR 3748, and etched boards without ECRs 3062 and 3342. Using -UNMDD 
with these boards prevents system hangs due to incorrect recovery from 
EMX overruns. 


19.0 
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The PHYSAV Dialog : After you invoke the subsystem, PHYSAV responds 
with a series of questions. PHYSAV requests information from you in 
the following order. Appropriate user responses are shown. 


Request 

UNIT NO: 


LOGICAL TAPE: 


Response 

Supply the physical tape unit number 
(0-7) f or you may type QUIT. (Reenter 
the subsystem fcy typing REN.) 

Specify 1 for the first logical tape, 2 
for the second, and so on. You may use 
0 to specify the current (or next) 
logical tape. 


Note 


There is no check for the 
previous existence of logical 
tape 1; the tape will be 
written from BOT. 


COMMENT Supply a comment up to 80 characters 

long. 

PHYS.DEV.NU: Specify the physical device number of 

the partition to be saved (40460, for 
example). 

USE THE RAT (YES/ND)? YES — Saves only tracks with records in 

use by the file system. 

NU — Saves all records of all tracks. 


Mote 

If you declare a split partition 
ty its true physical device 
number, then the paging portion 
will not be saved (even if you 
do not specify the RAT option). 
However, if it is part of 
several partitions declared as 
one, the entire partition is 
saved. 
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PHYSAV asks these questions if: 

(A) you are saving multiple partitions, 
and there is not enough information to 
distinguish the type of disk; 

or 

(B) the RAT is bad, and you are not 
using the RAT; 

or 

(C) the partition is not a file system 
partition, and you are not using the 
RAT. 

PARAMETERS OK (YES/NO) ? YES — Begins the save operation. 

NO — Exits from the subsystem. You may 
reenter by typing REN. 


40MB STORAGE MOD? 
600MB FIXED MEDIA? 


Reentering PHYSAV 

If you exit from PHYSAV for any reason, you may continue frcm the exit 
point by typing S. Restart facilities are also available at different 
points in the PHYSAV dialog by typing REN. You may do this anytime up 
to the final NO answer to the question: 

WRITE NEXT LOG.TAPE (YES/NO)? 

PHYSAV asks this question after it delivers a message announcing a 
completed save operation. With a NO response, you exit frcm the 
subsystem completely. If you respond with YES, you reenter the 
subsystem. 

If you reenter PHYSAV either this way or with the REN command, the 
subsystem does not start from the beginning. Rather, it begins frcm 
the latest, most convenient point. For example: 

• If you have not assigned the magnetic tape unit, you can type 
QUIT or CNIRL P in response to the UNIT NO: question, assign 
the magnetic tape unit, then reenter the subsystem at this point 
by typing REN. 

• If you have not assigned one of the partitions to be saved, the 
subsystem exits. You may then assign the partition and restart 
the subsystem frcm this point by typing REN. You will have to 
reenter the last physical device number, but PHYSAV will have 
remembered partition numbers you already entered. 
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• If you exit from the subsystem once the save operation has 
begun, you may continue from the exit point by typing S, or 
restart the latest section (logical tape or current reel, 
whichever is the most recent) by typing REN. 


Sample FHYSAV Session 


The following example illustrates a terminal session using PHYSAV: 

OK, PHYSAV 
REV 19.0 

DATE : JAN 18, 1982 TIME : 08.41 
UNIT NO: 0 
LOGICAL TAPE: 1 
COMMENT: 

This is a save on a Prime machine . 

PHYS.DEV.NO: 30462 

USE THE RAT (YES/ND)? YES 
PHYS.DEV.NO: 40462 
USE THE RAT (YES/NO) ? YES 
PHYS.DEV.NO: (CR) 

DISK HEAD OFFSET, #HEADS, SAVING 

030462 NEWSYS 6 2 RECORDS USED 

040462 OLDSYS 8 2 RECORDS USED 

PARAMETERS OK (YES/NO)? YES 

REEL: 1 LOG.TAPE: 1 SECTION: 1 

SAVE COMPLETE 

WRITE NEXT LOG.TAPE (YES/ND)? NO 
OK, 


PHYSAV Messages 

Messages you receive from PHYSAV are either informational or 
error-related. All PHYSAV messages are listed here alphabetically. An 
explanation is provided for each message. 


• BAD COMMAND LINE PARAMETER 

PHYSAV has encountered a parameter other than -TTY, -L0WEND, or -UNMDD. 
Retype a correct command line. 
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• BAD HEADER OR TAPE 

An error occurred while PHYSAV attempted to position to a logical tape 
greater than 1. There are three possibilities: 

— The tape has been started in an incorrect position (not 
immediately before a header label). 

— The tape was written using a subsystem other than PHYSAV. 

— The tape header is unreadable. 

You should rewind and try again, or restart the save on a new reel from 
logical tape 1. 


• BAD RAT OR NOT FILE SYSTEM PARTITION 

This is a warning message. If you are attempting to save the partition 
with the RAT, then PHYSAV will reject the partition entry. Otherwise, 
the subsystem continues. 


• CANNOT ERASE DATA (HW STATUS=xxxxxx) 

If a problen is encountered while a block, PHYSAV attempts to rewrite 
the bad block up to 20 times, erasing three more inches of tape each 
time while attempting to get over a bad section of the tape. If there 
are problems with erasing the tape, the latest section (frcm current 
reel or logical tape, whichever is most recent) must be rewritten. 

For an explanation of bit settings represented in the message by (HW 
STAIUS=xxxxxx), see Table 9-1, Magnetic Tape Controller Hardware 
Status. 


• CANNOT ERASE HEADER (HW STATOS=xxxxxx) 

If a problen is encountered while writing a magnetic tape header, 
PHYSAV attempts to rewrite it up to 20 times, each time erasing three 
more inches of tape to try to get over a possible bad section on the 
tape. If there are problems with erasing the tape, the latest section 
(from current reel or logical tape, whichever is most recent) must be 
rewritten. 

For an explanation of bit settings, see Table 9-1. 
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Table 9-1 

Magnetic Tape Controller Hardware Status 


Bit Setting 

Meaning 

100000 

Parity error 

040000 

Runaway tape 

020000 

CRC error 

010000 

LRC error 

004000 

Low EMX range 

002000 

Permanent error 

001000 

Read-after-write error 

000400 

File marker detected 

000200 

Read/ 

000100 

On-line 

000040 

End-of-tape detected 

000020 

Rewinding 

000010 

Beginning-of-tape (at load point) 

000004 

Tape is write-protected 

000002 

EMX overrun 

000001 

Rewind complete 
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• CANNOT ERASE TRAILER (HW STA'IUS=XXXXXX) 

If a problan is encountered while writing trailer labels, PHYSAV 
attempts to rewrite the labels up to 20 times, each time erasing three 
more inches of tape to try to get over a possible bad section on the 
tape. If there are problons with erasing the tape, then the latest 
section (from current reel or logical tape, whichever is most recent) 
must be rewritten. 

For an explanation of bit settings, see Table 9-1. 


• CANNOT WRITE HEADER (HW STATUS=xxxxxx) 

PHYSAV cannot write the first header of a logical tape. You have the 
option of either trying again on the same reel (in which case the 
subsystem will wind the tape to the correct position) or mounting a new 
reel. 

For an explanation of bit settings, see Table 9-1. 


• CANNOT WRITE TRAILER LABELS (HW STATUS=XXXXXX) 

If PHYSAV cannot successfully rewrite trailer labels, the latest 
magnetic tape section (from current reel or logical tape, whichever is 
most recent) must be rewritten. 

For an explanation of bit settings, see Table 9-1. 


• DISK ERROR WHILE ACCESSING RAT 

PHYSAV encountered a read error while trying to access the disk RAT. 
You should use FIX_DISK on the partition before you save it. 


• DISK READ ERROR, PARTITION aaaaaa, RECORD bbbbbb 

PHYSAV encountered an error while reading a disk record. (See also th e 
supervisor terminal listing.) The disk record will not be save on 
tape. If this is a known badspot, then this record does not form part 
of the file system. If it is a new badspot, you should use FIX_DISK on 
the partition after you restore it. The file whose record falls on 
this badspot will then be truncated. 
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EMX OVERRUN 


MX overrun oceurrcd during the magnetic tape write. The magnetic tape 
controller is at the wrong backplane priority and must be higher than 
the disk controller. 


• END OF INFORMATION 
LAST LOG.TAPE IS X 
WRITE LOG. TAPE X+l (YES/NO)? 


PHYSAV prints this message while positioning to a logical tape. PHYSAV 
detected the end of information before the requested logical tape was 
reached. You can either write the next logical tape in sequence, or be 
prompted again for unit number and logical tape number. 


• END OF REEL, MDUNT NEW REEL 

PHYSAV detected the end-of-physical-tape marker. The subsystem has 
correctly written trailer labels and it is reac^f to continue on the 
next physical reel. 


EOT DETECTED WHEN DOING ERROR RECOVERY SAVE WILL CONTINUE 



19.0 


If EOT id detected while PHYSAV is erasing tape after a recoverable 
write error, then the current block will not be written to tape. 
Instead, it will be the first block on the new tape. PHYSAV will 
attempt to write trailer labels and continue on the next reel. 


HARDWARE ERROR (HW STATUS=xxxxxx) 


An unrecoverable problem has occurred. You must first fix the problem 
before attempting to reenter the subsystem (using REN to restart from 
the beginning of the latest reel or logical tape). 


For an explanation of bit settings, see Table 9-1. 


• MORE THAN 10 PARTITIONS 


19.0 


At present, the largest disk that can be added to the system is a 600MB 
disk, which can contain a maximum of 10 partitions. 
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• MORE THAN y RECOVERED ERRORS 

If PHYSAV detects more than v recovered errors for one physical 
magnetic tape reel, the tape is considered suspect. By default, y is 
set to 50. (This can be changed with the parameter MAXERR and program 
recompilation.) PHYSAV asks you if you wish to rewrite the current 
section, although the tape is readable and need not be r writ ten. 


• NO PARTITIONS TO SAVE 

No partitions have been specified. Type REN to continue. 


• NO. OF PARTITIONS SO FAR = X 

This message occurs when reentering PHYSAV using the REN command. It 
indicates the number of partitions for which details have already been 
accepted by PHYSAV. 


• NOT AT B-O-T, TAPE BEING REWOUND 

PHYSAV expects a magnetic tape to be positioned at B-O-T each time you 
select a unit. 


19.0 


• NOT SAME CONTROLLER OR UNIT 

AH partitions to be saved in one logical tape must be on the same disk 
(connected to the same controller and on the same unit). 


• NOT STORAGE MODULE TYPE 

The only disks that can be saved using PHYSAV are: 
40MB, 80MB, 160, 300, and 600MB storage modules 
32MB, 64MB, and 96MB cartridge modules 

• PARTITION ALREADY SPECIFIED 

The partition has already been defined to PHYSAV. 
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• POSITIONING TO LOG.TAPE x 

The message occurs when positioning to a logical tape greater than 1. 


• RAT INCONSISTENT WITH PARTITION SIZE 

If are saving a partition using the RAT, it must be a true 
partition. Therefore, you cannot save multiple partitions declared as 
one whole partition using the RAT. 


• RE-ENTER LAST PHYS.DEV.NO. 

This message occurs when reentering PHYSAV (using REN), and indicates 
one of the following conditions: 

— You have not assigned a partition to be saved. 

— You did not specify any partitions to be saved. 

— You answered NO to the question PARAMETERS OK (YES/NO)?, but 
wish to reenter the subsystem to save a different combination of 
partitions. 

— You have exited from PHYSAV. 

PHYSAV remembers any partitions previously entered. 


• RE-ENTER UNIT NO. 

This message occurs when reentering PHYSAV (using REN). You have 

exited from PHYSAV before the subsystem accepted the magnetic tape unit 
number. 


• RESTARTING CURRENT REEL 

PHYSAy encountered a pr obi an while writing a continuation reel. You 

can either try the same physical reel again on the same or a different 
unit, or mount a new reel. 
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RESTARTING LOG.TAPE 


PHYSAV encountered a problan while writing the first section of a 
logical tape. You can either restart on the same reel (in which case 
the subsystem will wind the tape to the correct position) or mount a 
new reel. 


• RESTARTING PROGRAM 

Message when REN is typed after exit from program. 


• REWINDING 

This message occurs when a selected magnetic tape unit is rewinding. 


• REWRITE LOG.TAPE (YES/NO)? 

or REWRITE CURRENT REEL (YES/NO) ? 


Depending on the nature of the problem PHYSAV has encountered, you 
respond with either YES or NO: 

YES restarts the latest section. 


NO attempts a rewrite; lets the subsystem attempt recovery by 
backspacing to the magnetic tape block giving trouble. 


• TAPE IS WRITE PROTECTED 

A write-enable ring is not on the current tape reel. 


• THIS IS THE BEG. OF LOG.TAPE n 

The present reel starts with a logical tape number greater than the one 
requested. 



• THIS IS A CONTINUATION OF LOG.TAPE X 

PHYSAV detected a problem while trying to position to a logical tape 
greater than 1. The present reel is a continuation of the logical tape 
requested or of a logical tape with number .greater than the one 
requested. 
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• UNIT NOT READY OR OFFLINE 

You should put the unit on line or, if already on line, try another 
unit. This message also occurs if a magnetic tape runs off the end of 
reel (the EOT marker has not been detected or there is no EOT marker) 
or the tape has broken. In this case, you should rewind the tape and 
rewrite the latest section (from the start of logical tape or reel, 
whichever is the most recent) on a new iragnetic tape reel or unit. 


• UNREOOVERED ERROR (HW STATUS=XXXXXX) 

PHYSAV attempts to rewrite a magnetic tape block up to 20 tines, 
erasing three more inches of tape each time in an attempt to get over a 
local badspot. If PHYSAV is unsuccessful after 20 attempts, this error 
occurs. You must rewrite the current section. 

For an explanation of bit settings, see Table 9-1. 


• USE NEW REEL (YES/NO)? 

PHYSAV encountered a problem while writing the first section of a 
logical tape greater than 1. You can either try to restart using the 
same reel (PHYSAV winds the tape to the correct position) or restart at 
the start of a new reel. 


• WARNING, LOG TAPE ALREADY EXISTS 

OVERWRITE EXISTING LOG. TAPE x (YES/NO)? 

This is a warning message. PHYSAV attempted to position to the start 
of a logical tape. If you reply YES, PHYSAV overwrites the logical 
tape and cannot access any subsequent logical tapes previously 
overwritten. If you reply NO, the tape is rewound and you are prompted 
for a unit number and a logical tape number. 


• WARNING - MULTIPLE PARTITIONS 
CANNOT AVOID POSSIBLE BADSPOTS 

This is a warning message. If you have declared several partitions as 
one, then PHYSAV cannot access a BADSPT file on each partition. If 
there are no badspots, there will be no problem. If there are known 
badspots, then DISK READ ERRORS will be reported when PHYSAV tries to 
read bad records. In either case, the saved partition will still be 
complete. 
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• WRITING LOG. TAPE 1 

PHYSAV is about to write logical tape 1. This message is intended as a 
warning that the tape is to be overwritten. 


IHE PHYRST SUBSYSTEM 

PHYRST restores one or more partitions saved with PHYSAV to assigned 
partitions of the same size. It is not necessary to restore all saved 
partitions in one run. PHYRST runs in R-mode under either PRIMDS II or 
PRIMOS. 

A verify facility is available to verify the readability of a magnetic 
tape. The tape is read (as for the restore operation), but the 
information is not written to disk. The verify facility does not 
verify that all the data has been written to the tape. It only 
verifies that all tape blocks are readable and in sequence. 


Running PHYRST 

PHYRST allows you to restore assigned partitions from a magnetic tape 
written with PHYSAV. Partitions being restored do not have to be on 
the same controller or unit. However, a saved partition can only be 
restored to another partition of equal size. You do not have to 
restore all partitions saved on your tape. You can restore only one 
partition if you wish. You can also, at PRIM3S level, restore a 
command partition. For detailed information, see the Syston Operator 1 s 
Guide . 

The PHYRST command line format is as follows: 

PHYRST [-TTY] [-ISD_BADS] [-UNM0D] 

The -TTY option causes PHYRST to request its magnetic tape user number 
from the terminal, even if the utility is being run from a CPL or 
OOMINPUT file. 

The -NCLBADS option disables badspot handling. If this option is not 
given, FHYRST does handle badspots, as explained in the section on 
Badspot Handling , later in this chapter. (Badspot handling is 
available on Rev. 19 disks only.) 

The -UNMOD command line option functions the same for PHYRST as it does 
for PHYSAV. 


The PHYRST Dialog: After you invoke the subsystan, PHYRST responds 
with a series of questions. PHYRST requests information frcm you in 
the following order. Appropriate user responses are shown. 
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Request Response 

UNIT NO: Supply the physical tape unit number 

(0-7), or you may type QUIT. (Reenter 
the subsystan ty typing S 1000.) 

LOGICAL TAPE: Specify 1 for the first logical tape, 2 

for the second, and so on. You may 
specify 0 for the current (or next) 
logical tape. 

CORRECT TAPE (YES/NO)? YES — Continues PHYRST. 

NO — Prompts you again for a unit 
number. 

After the requested logical tape is 
found, PHYRST prints out the details of 
the saved information. 

RESTORE ALL PARTITIONS TO ORIGINAL POSITIONS (YES/NO)? 

YES — Restores all partitions to their 
original positions. 

NO — Asks if each partition is to be 
restored as it is saved. 

RESTORE PARTITION xxxxxx '(YES/NO)? 

NO — Prompts with the next partition 
saved. 

YES — Generates the next dialog 
question. 

AS PARTITION: Supply either a physical device number or 

type a (CR): 

Pdn — The physical device number to 
which the partition is to be restored. 

(CR) — Causes the partition to be 
restored to its original position. 

PARAMETERS OK (YES/NO)? NO — Exits you from PHYRST. (Type S 

1000 to reenter.) 

YES — Begins the restore operation. 
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Badspot Handling 


When PHYRST is restoring material onto a Rev. 19 partition (that is, a 
partition which has been formatted by Rev. 19 MAKE and which is running 
under Rev. 19 PRIMOS), it attempts to ensure that no records are 
written onto any badspots the disk might contain. 


PHYRST does not handle badspots if any of the following conditions are 
true: 

• You are copying the tape onto a Rev. 18 (or earlier) partition. 





You are running a Rev. 18 version of PHYRST. 

You are copying onto a disk partition which has no BADSPT file. 

You are copying either to or from a partition which has a bad 
BADSPT file. 


• You give the -NCLBADS option when you invoke PHYRST. 





How PHYRST Handles Badspots : PHYRST performs badspot handling in the 
following manner: 

1. Before writing a record (r) onto the disk, PHYRST checks the 
disk's BADSPT file to see whether the target record (t) is good 
or bad. (Rev. 19 BADSPT files mark individual records, not 
entire tracks.) 


19.0 


2. If record t is good, PHYRST writes record r_ onto it. 

3. If record t is bad, PHYRST looks in the DSKRAT file copied from 
the source disk for a free record. 


4. If it finds a free record (f) available, PHYRST copies record r 
onto it. It then adds an EQUIVALENCE block to the BADSPT file, 
showing that the record originally intended for record t has 
been written onto record f. 

5. If there is no free record available, PHYRST prints the 
message: 

NO FREE RECORDS AVAILABLE ON PARTITION pdev 
OK TO WRITE IT WITHOUT BADSPOT HANDLING (YES/NO) ? 

If you answer YES, PHYRST finishes copying the partition 
without badspot handling. If you answer NO, PHYRST exits. You 
may then run PHYRST again, using a partition that has fewer 
badspots. (If you do continue the copy, there will be no 
BADSPT file left on the target disk.) 
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6 . 


If badspot handling has occurred, then 
following message at the end of the copy: 


PHYRST prints the 


BADSPOTS HANDLED ON PARTITION pdev 

If you receive this message, the operator should run FIX_DISK 
on the partition specified. FIX_DISK will correct the pointers 
involved in the badspot renapping, and will then erase the 
EQUIVALENCE block. 


Reentering PHYRST 

PHYRST runs in R-mode. Consequently, you cannot reenter it with the 
REN command as you can with PHYSAV. If you exit or QUIT from PHYRST 
for any reason (a partition is not assigned, for example), you can 
reenter by typing S 1000. PHYRST restarts from the latest convenient 
point. For example, if a partition is not assigned, PHYRST restarts 
from the beginning of the section that specifies partitions to be 
restored. 


If you type QUIT during a restore operation, PHYRST restarts from the 
beginning of the latest section (logical tape or current reel, 
whichever was most recently started). Typing S always continues the 
subsystem. 


19.0 


Sample PHYRST Session 


The following example illustrates a terminal session using PHYRST: 


OK, PHYRST 
REV 19.0 
UNIT NO: 0 
LOGICAL TAPE: 1 

REEL: 1 LOG.TAPE: 



1 SECTION: 1 


DATE: JAN 18, 1982 AT 14:22 
This is a save on a Prime machine. 
PARTITIONS SAVED 
030462 NEWSYS 
040462 OLDSYS 


CORRECT TAPE (YES/NO)? YES 
RESTORE OR VERIFY (RE/VE)? RE 

RESTORE ALL PARTITIONS TO ORIGINAL POSITIONS (YES/NO)? NO 
RESTORE PARTITION 030462 (YES/NO)? NO 
RESTORE PARTITION 040462 (YES/NO)? YES 
AS PARTITION: 100462 
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disk to be restored as 

040462 OLDSYS 100462 


PARAMETERS OK (YES/NO) ? YES 

REEL: 1 LOG.TAPE: 1 SECTION: 1 

RESTORE COMPLETE 

RESTORE/VERIFY NEXT LOG.TAPE (YES/NO)? NO 
OK, 


19.0 


PHYRST Messages 

Messages you receive from PHYRST are either informational or 
error-related. All PHYRST messages are listed here alphabetically. An 
explanation is provided for each message. 


• BAD BADSPT FILE ON PARTITION pdev -IGNORED 

The BADSPT file on either the source or the target partition is in seme 
way inconsistent. PHYRST will not try to do badspot handling. 


• BAD COMMAND LINE PARAMETER 


A parameter other than -UNMOD, -TTY or -N0_BADS has been encountered. 
The command line should be re-typed correctly. 


19.0 


• BAD HEADER OR TAPE 

This error is output if a magnetic tape header cannot be read. Ihe 
tape is either: 

— Not positioned correctly 

— NOt written by the PHYSAV utility 

— Damaged 


• BADSPOTS HANDLED ON PARTITION pdev 

PHYRST has handled badspots during its restore of partition pdev , 
remapping sane records and creating an equivalence block. The operator 
must run FIXJDISK on this partition before it is used for any reason 
other than as a target for PHYRST or G0PY_DISK. 
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• BADSPT FILE ON PARTITION pdev HAS AN EQUIVALENCE BLOCK 
PLEASE RUN FIX_DISK 

A partition was saved whose BADSPT file contained an equivalenc. 
PHYRST cannot deal with this situation. PHYRST will abort after 
printing this message. 


• CORRECT TAPE (YES/NO)? 

This message is generated after the magnetic tape has been positioned 
to the correct logical tape. Details of the save will have been 
produced before you receive this message. 


YES causes the program to prompt the user for the partitions to be 
restored. 

NO prompts the user for a new magnetic tape unit number. 


• DISK WRITE ERROR, PARTITION aaaaaa, RECORD bbbbbb 

Either PHYRST has encountered a new bads pot, or the address of the 
record to be written was incorrectly read from the tape. 

You should check the record address to see if it lies within the 
partition being restored, type QUIT, and retry the current reel by 
typing S 1000. Use FIX_DISK on the partition when the restore is 
complete. 


• EMX OVERRUN 

EMX overrun has occurred on a magnetic tape read. This means that the 
magnetic tape controller is at the wrong backplane priority; it must 
be higher than the disk controller. 


• END OF INFORMATION 
LAST LOG.TAPE = X 

The logical tape requested does not exist on this magnetic tape. 
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• END OF REEL, MOUNT NEW REEL 

This message is output when a physical E-O-T marker has been 
encountered: 

— While positioning to a logical tape. 

— While restoring partition(s) from a logical tape. 

— While verifying a tape. 

The program is ready to continue with the next reel. 


• ERROR, EOT READ 

PHYRST should never encounter an EOT if it is reading the 
trailer/header labels first. Information may have been lost here. 
Restart PHYRST to restore any subsequent reels that belong to the same 
logical tape. Use FIX_DISK on the partitions after the restore is 
complete. You could also try a different magnetic tape unit for the 
same reel. 


• HARDWARE ERROR (HW STATUS=XXXXXX) 

This message indicates an unrecoverable error. It is followed by the 
message: 

RESTART CURRENT REEL (YES/ND)? 
or 

RESTART LOG.TAPE (YES/NO)? 

If you reply NO, PHYRST continues by treating the error as recoverable. 
In other words, it backspaces five blocks, repositions to the block 
causing the problem, and attempts to read the block up to 20 times. 

If this is unsuccessful, PHYRST prints: 

UNREOOVERED ERROR (HWSTAT=xxxxxx), BLOCK z 
RESTART CURRENT REEL (YES/NO)? 
or 

RESTART LOG.TAPE (YES/NO)? 
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If you reply NO, PHYRST tries to read up to 20 successive blocks in an 
attempt to find a good block from which to continue. For an 
explanation of bit settings, see Table 9-1. If still unsuccessful, 
PHYRST prints: 


MORE THAN 20 SUCCESSIVE ERRORS 
RESTART CURRENT REEL (YES/NO)? 
or 

RESTART LOG.TAPE (YES/NO)? 

If you reply NO, PHYRST tries again to read up to 20 successive blocks. 


• MORE THAN 20 SUCCESSIVE ERRORS 


PHYRST detected an unreoovered error, continued, and discovered 20 
successive bad blocks. You can either try the next 20 blocks or 
restart the current section on the same or a different magnetic tape 
unit. 


• NO FREE RECORDS AVAILABLE ON PARTITION pdev 

OK TO WRITE IT WITHOUT BADSPOT HANDLING (YES/NO) ? 


19.0 


PHYRST has tried 
is available. 


to map a record around a badspot, but no free record 


If you reply YES to this message, PHYRST will continue its copy without 
further bads pot handling. Information falling on bads pots will be 
lost. 


If you reply NO, PHYRST will exit. You may try to copy the tape onto a 
partition which has few badspots. 


• NO PARTITIONS TO RESTORE 

This is an informational message. You answered NO when PHYRST asked 
you if it should restore each of the partitions saved on tape. 


• NOT AT B-O-T, TAPE BEING REWOUND 


19.0 


The program expects each magnetic tape to be at the load point 
unit number is selected. Unless the user is sure that the 
correctly positioned (i.e. immediately before a magnetic tape 
the tape should be rewound. 


when the 
tape is 
header), 
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NOT SAME REEL 


PHYRST has encountered problems, and is consequently attanpting to 
restart the latest section. However, the tape that it found mounted on 
the new unit is not the original one. 


• NOT STORAGE MODULE TYPE 

The only disks supported by this utility are: 

40MB, 80MB, 160MB, 300MB and 600MB storage modules 
32MB, 64MB, and 96MB cartridge modules. 



• PARTITION ALREADY SPECIFIED 

Either a partition to be restored or one to be restored from, has 
already been entered. 





RESTART LOG.TAPE (YES/NO)? 
or 

RESTART CURRENT REEL (YES/NO)? 


PHYRST has encountered problems with the current section. See the 
description for HARDWARE ERROR. 


RESTARTING LOG.TAPE 
or 

RESTARTING CURRENT REEL 


One of the following has happened: 

— An unrecovered error occurred. 

— You requested that PHYRST restart the current section. 
— You exited and typed S 1000. 
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RESTORE COMPLETE 

RESTORE/VERIFY NEXT LOGICAL TAPE (YES/ND)? 


All of the partitions that you requested to be restored from one 
logical tape have been restored. You can go on to the next logical 
tape by typing YES. Otherwise, PHYRST exits. 


• REWINDING 

This message is output is the magnetic tape mounted on the unit 
selected is still rewinding. 




THIS IS BEG. 


OF LOG.TAPE 


x 
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A logical tape has been found with a number larger than the one 
requested to be restored. PHYRST will print information about the 
tape, then ask 'CORRECT TAPE (YES/NO).' If this is the correct tape, 
answer YES. PHYRST will restore the tape as usual. If it is not the 
correct tape, answer NO. PHYRST will then ask again for a tape unit 
number. 


• THIS IS A CONTINUATION OF LOG. TAPE X 
See previous message. 


• THIS REEL DOES NOT FOLLOW LAST 
CONTINUE (YES/NO)? 


A continuation reel has been mounted during a normal 
which either is out of sequence or is not part of 
save tapes. 


restore operation 
the current set of 


• UNEQUAL NO. OF HEADS 

You can only restore a partition to one of equal size. 


19.0 


• UNIT NOT READY OR OFFLINE 
A selected unit is not ready or off-line. 
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• UNRBOOVERED BLOCK SEQUENCE ERROR, BLOCK X 

PHYRST has read a block whose sequence number does not follow that of 
the previous one. An incomplete dump without trailer labels may exist 
on the tape, and information written previously has now been read. 


• UNRECOVERED ERROR (HW STATUS=xxxxxx), BLOCK x 

An attempt has been made to read a block and it has been unsuccessful 
20 times in a row. The user can continue or restart the latest section 
on the same or a new unit. 

For an explanation of the bit settings in the HW status, see Table 9-1. 


• X UNRECOVERED MT ERROR(S) 

************* 

RUN FIX_DISK 
************* 

PHYRST has detected one or more unrecovered magnetic tape errors. You 
should run FIX_DISK to see if any vital information has been lost. For 
example, if the entire partition has been saved, tracks may have been 
lost that were not in use by the file systan. 


• VERIFY COMPLETE 

RESTORE/VERIFY NEXT LOGICAL TAPE (YES/NO) ? 

This is an informational message informing you that the logical tape 
has been verified. 
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A 

MAGNET Edit Tokens, 
Character Set Tables, 
and Translation Tables 


TRANSLATION EDIT TOKENS 

Edit tokens are part of the MAGNET TRANSLATE subcommand line. Each 
edit token specifies how you want particular fields of a logical record 
translated. All MAGNET edit tokens are described in detail in the 
following paragraphs. (For more information on the TRANSLATE 
subcommand and edit tokens, see Chapter 7.) 


Edit Token A 

All characters specified with edit token A translate to or from 
industry-standard ASCII. When you are reading from a tape, this means 
translating from industry-standard ASCII to Prime ASCII. When you are 
writing to a tape, this means translating from Prime ASCII to 
industry-standard ASCII. For example, if you have 80-character 
industry-standard ASCII logical records on an input tape, you could 
specify the following: 

(A80) 

Note that you may also specify this translation as (80 (Al)), but this 
format processes much more slowly. 
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Edit Token B 


This edit token translates seven-track BCDIC code to Prime ASCII, and 
vice versa. For example, if you have declared a tape object named 
BANKST consisting of 120-character logical records, your TRANSLATE 
subcommand line may be: 

> TRANSLATE BANKST (E120) 


This causes each of the 120 characters in a logical record to be 
translated from seven-track BCDIC code to Prime ASCII if you are using 
BANKST as an input object. Again, note that you can also use the form 
(120(Bl)), but it processes much more slowly. 


Edit Token C 

This is the column position edit token. You use it to move to a field 
in a logical record. It causes MAGNET'S internal pointer to position 
to a different location. For example, assuming input from a tape, the 
string: 

(A80 ,C10 ,A10) 

causes the following to occur: 

• Character columns 1 through 80 are translated from 

industry-standard ASCII to Prime ASCII. 

• You are repositioned to column 10. 

• Character columns 10 through 19 are translated from 

industry-standard ASCII to Prime ASCII. 

In this example, output from the translation process is 90 characters 
even though the length of the input logical record is only 80 
characters. Note that columns 10 through 19 are translated twice and 
will appear twice in the output. However, in the following example, 
less characters will appear on output: 

(A40 ,C71,A10) 

Here, character columns 41 through 70 are not translated and are 
effectively deleted from the output. 
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Edit Token D 

This is the deletion edit token. It allows you to delete characters. 
For example, the string: 

(A40 ,D30,A10) 

performs the same task as the previous example. In other words, 
(A40,C71,A10) is equivalent to (A40,D30,A10). 


Edit Token E 

This edit token translates EBCDIC code to Prime ASCII, and vice versa. 
For example, the string: 

(E100) 

causes 100 characters to be translated from EBCDIC to Prime ASCII or 
vice versa. 

Edit Token F 

This edit token allows you to specify fill characters. These 
characters may be any symbols except the following: 

• Comma 

• Left and right parentheses "(" and ")" 

• Slash "/" 

• Apostrophe "'" 

Note that alpha characters are always translated to uppercase. For 
example, the string: 

(A10,10 (F*) ,C20,A20,10 (FX)) 

causes the following to occur: 

• 10 characters are translated using A format. 

• 10 asterisks (*) are inserted into the output record. 

• You are positioned to column 20. 

• 20 characters (columns 20 through 39) are translated using A 
format. 
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• 10 X's are inserted into the output record. 

The output record contains 50 characters. If you specify this edit 
token by itself, without any fill character, a blank is inserted. The 
string: 

(20(F)) 

causes 20 blanks to be inserted. 


Edit Tokens G through N 

These eight edit tokens specify seven-track packing and unpacking 
codes. (For more information, see Chapter 1.) Edit tokens G through N 
and their corresponding packing codes are as follows: 


Edit Token 

G 

H 

I 

J 

K 


Packing Code 

2424 

4242 

2466 

4266 

6246 


L 6426 
M 6624 
N 6642 

The repetition factor you specify for these edit tokens is a byte 
count. Thus, if you wish to pack, on input, three binary numbers in K 
format, you specify (K9). You use the number 9 because each binary 
number on input occupies three bytes. On output, each binary number 
occupies only two bytes or one 16-bit word. Likewise, G and H format 
binary numbers occupy four bytes on input from a tape and occupy two 
bytes on output to disk. When you are writing to a tape, binary 
numbers are expanded from two bytes to four bytes for G and H formats, 
and to three bytes for I, J, K, L, M, and N formats. When you are 
determining logical record lengths for tape and disk objects, you must 
take into account seven-track binary number expansion and compression. 

In the following example, 20 binary numbers are translated usinq H 
format: 


(H80) 
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Edit Token 0 

You use this edit token to specify no translation in your TRANSLATE 
subcoiaraand line. For example, the subcommand line: 

> TRANSLATE ACCOUNTS (OlOO) 

> 

causes each logical record in ACCOUNTS to be transferred through the 
translation mechanism without any translation occurring (assuming that 
each logical record is 100 characters long). 


Edit Token P 

This edit token enforces Prime ASCII input and output. In other words, 
the high-order bit of each byte is set on, if it is not already. For 
example, the subcommand line: 

> TRANSLATE ACCOUNTS (P100) 

> 

causes the high-order bit of each byte of each logical record to be set 
on. 


Edit Tokens Q through U 

These edit tokens do not specify anything at this time. They are 
reserved for future use. 


Edit Tokens V through Z 

These five edit tokens specify user-defined translation codes. (For 
more information, see Chapter 7.) You use these edit tokens the same 
way you use edit tokens A, B, E, 0, and P. One character of input is 
translated according to the table you loaded with a LOAD subcommand and 
becomes one character of output. 


Repetition Factor * 

If you wish to specify translation for the remaining characters of a 
logical record without specifying an absolute number, you may use the 
repetiton factor *. For example, the subcommand line: 

> TRANSLATE WUMPUS (A*) 

> 
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causes the following to occur: 

• 29 characters are translated according to E format. 

• 10 characters or bytes are not translated. 

• Three blanks are inserted. 

• All remaining characters are translated according to E format. 
CHARACTER SET TABLES 

These character set tables are from the following sources: 


• ASCII - American National 
X3.4-1977. 


Standards Institute standard 




Edition, 
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Industry-standard ASCII 


" => control key depressed 


8-Bit 

Octal 

Code 

Char 


Octal Code 

When in 

Left Byte 

8-Bit 

Octal 

Code Char 

Octal Code 
When in 
Left Byte 

000 

NUL 


0000 

040 Sp 

0200 

001 

SCH 

"A 

0004 

041 ! 

0204 

002 

STX 

~B 

0010 

042 " 

0210 

003 

ETX 

~C 

0014 

043 # 

0214 

004 

EOT 


0020 

044 $ 

0220 

005 

ENQ 

"E 

0024 

045 % 

0224 

006 

ACK 

~F 

0030 

046 & 

0230 

007 

BEL 


0034 

047 ' 

0234 

010 

BS 


0040 

050 ( 

0240 

Oil 

HT 

"I 

0044 

051 ) 

0244 

012 

LF 


0050 

052 * 

0250 

013 

VT 


0054 

053 + 

0254 

014 

FF 


0060 

054 , 

0260 

015 

CR 


0064 

055 - 

0264 

016 

SO 

~N 

0070 

056 . 

0270 

017 

SI 

"O 

0074 

057 / 

0274 

020 

DLE 


0100 

060 0 

0300 

021 

DC1 

"Q 

0104 

061 1 

0304 

022 

DC2 


0110 

062 2 

0310 

023 

DC3 

'■s 

0114 

063 3 

0314 

024 

DC4 

~T 

0120 

064 4 

0320 

025 

NAK 

~U 

0124 

065 5 

0324 

026 

SYN 


0130 

066 6 

0330 

027 

EIB 

~W 

0134 

067 7 

0334 

030 

CAN 

"X 

0140 

070 8 

0340 

031 

EM 


0144 

071 9 

0344 

032 

SUB 


0150 

072 : 

0350 

033 

ESC 


0154 

073 ; 

0354 

034 

FS 


0160 

074 < 

0360 

035 

GS 


0164 

075 = 

0364 

036 

RS 

/S/\ 

0170 

076 > 

0370 

037 

US 

A 

0174 

077 ? 

0374 
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8-Bit 

Octal Code 

Octal 

When in 

Code Char 

Left Byte 

100 @ 

0400 

101 A 

0404 

102 B 

0410 

103 C 

0414 

104 D 

0420 

105 E 

0424 

106 F 

0430 

107 G 

0434 

110 H 

0440 

111 I 

0444 

112 J 

0450 

113 K 

0454 

114 L 

0460 

115 M 

0464 

116 N 

0470 

117 0 

0474 

120 P 

0500 

121 Q 

0504 

122 R 

0510 

123 S 

0504 

124 T 

0520 

125 U 

0524 

126 V 

0530 

127 W 

0534 

130 X 

0540 

131 Y 

0544 

132 Z 

0550 

133 [ 

0554 

134 \ 

0560 

135 ] 

0564 

136 ~ 

0570 

137 

0574 


8-Bit 

Octal Code 

Octal 

When in 

Code Char 

Left Byte 

140 ' 

0600 

141 a 

0604 

142 b 

0610 

143 c 

0614 

144 d 

0620 

145 e 

0624 

146 f 

0630 

147 g 

0634 

150 h 

0640 

151 i 

0644 

152 j 

0650 

153 k 

0654 

154 1 

0660 

155 m 

0664 

156 n 

0670 

157 o 

0674 

160 p 

0700 

161 q 

0704 

162 r 

0710 

163 s 

0714 

164 t 

0720 

165 u 

072 4 

166 v 

0730 

167 w 

0734 

170 x 

0740 

171 y 

0744 

172 z 

0750 

173 { 

0754 

174 | 

0760 

175 } 

0764 

176 ~ 

0770 

177 DEL 

0774 
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Prime ASCII 

F => Valid filename character 
R => Reserved command line character 
=> Control key depressed 


8-Bit 


Octal Code 

8-Bit 

Octal 


When in 

Octal 

Code Char 


Left Byte 

Code Char 

200 

NUL 

A @ 

1000 

240 

Sp 

201 

see 

"A 

1004 

241 

1 

202 

STX 

a b 

1010 

242 

It 

203 

ETX 

A c 

1014 

243 

# 

204 

EOT 

a d 

1020 

244 

$ 

205 

ENQ 

a e 

1024 

245 

% 

206 

ACK 

a f 

1030 

246 

& 

207 

BEL 

A G 

1034 

247 

1 

210 

BS 

a h 

1040 

250 

( 

211 

HT 

A I 

1044 

251 

) 

212 

LF 

A J 

1050 

252 

* 

213 

VT 


1054 

253 

+ 

214 

FF 

a l 

1060 

254 

9 

215 

CR 


1064 

255 

- 

216 

SO 


1070 

256 

• 

217 

SI 

A o 

1074 

257 

/ 

220 

DLE 

A P 

1100 

260 

0 

221 

DC1 

"Q 

1104 

261 

1 

222 

DC2 

a r 

1110 

262 

2 

223 

DC3 

A s 

1114 

263 

3 

224 

DC4 

"T 

1120 

264 

4 

225 

NAK 

A u 

1124 

265 

5 

226 

SYN 

"V 

1130 

266 

6 

227 

ETB 

"w 

1134 

267 

7 

230 

CAN 

A x 

1140 

270 

8 

231 

EM 

~Y 

1144 

271 

9 

232 

SUB 

A z 

1150 

272 

• 

• 

233 

ESC 

*[ 

1154 

273 

• 

# 

234 

FS 


1160 

274 

< 

235 

GS 

*] 

1164 

275 

= 

236 

RS 

AA 

1170 

276 

> 

237 

US 


1174 

277 

? 


A-9 


Octal Code 
When in 
Left Byte 


1200 
1204 R 
1210 R 
1214 F 
1220 F 
1224 R 
1230 FR 
1234 R 
1240 R 
1244 R 
1250 F 
1254 
1260 R 
1264 FR 
1270 F 
1274 F 
1300 F 
1304 F 
1310 F 
1314 F 
1320 F 
1324 F 
1330 F 
1334 F 
1340 F 
1344 F 
1350 R 
1354 R 
1360 
1364 R 
1370 
1374 
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8-Bit 

Octal Code 

8-Bit 

Octal Code 

Octal 

When in 

Octal 

When in 

Code Char 

Left Byte 

Code Char 

Left Byte 

300 

@ 

1400 R 

340 

\ 

1600 R 

301 

A 

1404 F 

341 

a 

1604 

302 

B 

1410 F 

342 

b 

1610 

303 

C 

1414 F 

343 

c 

1614 

304 

D 

1420 F 

344 

d 

1620 

305 

E 

1424 F 

345 

e 

1624 

306 

F 

1430 F 

346 

f 

1630 

307 

G 

1434 F 

347 

g 

1634 

310 

H 

1440 F 

350 

h 

1640 

311 

I 

1444 F 

351 

i 

1644 

312 

J 

1450 F 

352 

j 

1650 

313 

K 

1454 F 

353 

k 

1654 

314 

L 

1460 F 

354 

1 

1660 

315 

M 

1464 F 

355 

m 

1664 

316 

N 

1470 F 

356 

n 

1670 

317 

0 

1474 F 

357 

0 

1674 

320 

P 

1500 F 

360 

P 

1700 

321 

Q 

1504 F 

361 

q 

1704 

322 

R 

1510 F 

362 

r 

1710 

323 

S 

1514 F 

363 

s 

1714 

324 

T 

1520 F 

364 

t 

1720 

325 

U 

1524 F 

365 

u 

1724 

326 

V 

1530 F 

366 

V 

1730 

327 

W 

1534 F 

367 

w 

1734 

330 

X 

1540 F 

370 

X 

1740 

331 

y 

1544 F 

371 

y 

1744 

332 

z 

1550 F 

372 

z 

1750 

333 

[ 

1554 R 

373 

{ 

1754 R 

334 

\ 

1560 R 

374 

1 

1760 

335 

] 

1564 R 

375 

} 

1764 R 

336 


1570 R 

376 


1770 R 

337 


1574 F 

377 

DEL 

1774 
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MAGNET EDIT TOKENS 


EBCDIC 


Decimal Octal Hex. Char. 


000 

000 

00 

NUL 

001 

001 

01 

SOH 

002 

002 

02 

STX 

003 

003 

03 

ETX 

004 

004 

04 

PF 

005 

005 

05 

HT 

006 

006 

06 

LC 

007 

007 

07 

DEL 

008 

010 

08 


009 

Oil 

09 


010 

012 

OA 

SMM 

Oil 

013 

OB 

VT 

012 

014 

OC 

FF 

013 

015 

OD 

CR 

014 

016 

OE 

SO 

015 

017 

OF 

SI 

016 

020 

10 

DLE 

017 

021 

11 

DC1 

018 

022 

12 

DC2 

019 

023 

13 

•m 

020 

024 

14 

RES 

021 

025 

15 

NL 

022 

026 

16 

BS 

023 

027 

17 

IL 

024 

030 

18 

CAN 

025 

031 

19 

EM 

026 

032 

1A 

CC 

027 

033 

IB 

CU1 

028 

034 

1C 

IFS 

029 

035 

ID 

IGS 

030 

036 

IE 

IRS 

031 

037 

IF 

IUS 


A-ll 


Decimal 

Octal 

Hex. 

Char. 

032 

040 

20 

DS 

033 

041 

21 

SOS 

034 

042 

22 

FS 

035 

043 

23 


036 

044 

24 

BYP 

037 

045 

25 

LF 

038 

046 

26 

ETB 

039 

047 

27 

ESC 

040 

050 

28 


041 

051 

29 


042 

052 

2A 

SM 

043 

053 

2B 

CU2 

044 

054 

2C 


045 

055 

2D 

ENQ 

046 

056 

2E 

ACK 

047 

057 

2F 

BEL 

048 

060 

30 


049 

061 

31 


050 

062 

32 

SYN 

051 

063 

33 


052 

064 

34 

IN 

053 

065 

35 

RS 

054 

066 

36 

UC 

055 

067 

37 

EOT 

056 

070 

38 


057 

071 

39 


058 

072 

3A 


059 

073 

3B 

CU3 

060 

074 

3C 

DC4 

061 

075 

3D 

NAK 

062 

076 

3E 


063 

077 

3F 

SUB 
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Decimal 

Octal 

Hex. 

Char. 

064 

100 

40 

SP 

065 

101 

41 


066 

102 

42 


067 

103 

43 


068 

104 

44 


069 

105 

45 


070 

106 

46 


071 

107 

47 


072 

110 

48 


073 

111 

49 


074 

112 

4A 


075 

113 

4B 

• 

076 

114 

4C 

< 

077 

115 

4D 

( 

078 

116 

4E 

+ 

079 

117 

4F 


080 

120 

50 


081 

121 

51 


082 

122 

52 


083 

123 

53 


084 

124 

54 


085 

125 

55 


086 

126 

56 


087 

127 

57 


088 

130 

58 


089 

131 

59 


090 

132 

5A 

1 

091 

133 

5B 

$ 

092 

134 

5C 

* 

093 

135 

5D 

) 

094 

136 

5E 

• 

t 

095 

137 

5F 



Decimal Octal Hex. Char. 

096 140 60 

097 141 61 / 

098 142 62 

099 143 63 

100 144 64 

101 145 65 

102 146 66 

103 147 67 

104 150 68 

105 151 69 

106 152 6A 

107 153 6B 

108 154 6C 

109 155 6D 

110 156 6E > 

111 157 6F ? 

112 160 70 

113 161 71 

114 162 72 

115 163 73 

116 164 74 

117 165 75 

118 166 76 

119 167. 77 

120 170 • 78 

121 171 79 

122 172 7A : 

123 173 7B # 

124 174 7C @ 

125 175 7D • 

126 176 7E 

127 177 7F 


First Edition 


A-12 
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MAGNET EDIT TOKENS 


Decimal 

Octal 

Hex. 

Char. 

Decinal 

Octal 

Hex. 

Char. 

128 

200 

80 


160 

240 

A0 


129 

201 

81 

a 

161 

241 

A1 


130 

202 

82 

b 

162 

242 

A2 

s 

131 

203 

83 

c 

163 

243 

A3 

t 

132 

204 

84 

d 

164 

244 

A4 

u 

133 

205 

85 

e 

165 

245 

A5 

V 

134 

206 

86 

f 

166 

246 

A6 

w 

135 

207 

87 

g 

167 

247 

A7 

X 

136 

210 

88 

h 

168 

250 

A8 

y 

137 

211 

89 

i 

169 

251 

A9 

z 

138 

212 

8A 


170 

252 

AA 


139 

213 

8B 


171 

253 

AB 


140 

214 

8C 


172 

254 

AC 


141 

215 

8D 


173 

255 

AD 


142 

216 

8E 


174 

256 

AE 


143 

217 

8F 


175 

257 

AF 


144 

220 

90 


176 

260 

B0 


145 

221 

91 

j 

177 

261 

B1 


146 

222 

92 

k 

178 

262 

B2 


147 

223 

93 

1 

179 

263 

B3 


148 

224 

94 

m 

180 

264 

B4 


149 

225 

95 

n 

181 

265 

B5 


150 

226 

96 

o 

182 

266 

B6 


151 

227 

97 

P 

183 

267 

B7 


152 

230 

98 

q 

184 

270 

B8 


153 

231 

99 

r 

185 

271 

B9 


154 

232 

9A 


186 

272 

BA 


155 

233 

9B 


187 

273 

BB 


156 

234 

9C 


188 

274 

BC 


157 

235 

9D 


189 

275 

BD 


158 

236 

9E 


190 

276 

BE 


159 

237 

9F 


191 

277 

BF 
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Decimal 

Octal 

Hex. 

Char. 

Decimal 

Octal 

Hex. 

Char. 

192 

300 

CO 

{ 

224 

340 

E0 

\ 

193 

301 

Cl 

A 

225 

341 

El 

194 

302 

C2 

B 

226 

342 

E2 

S 

195 

303 

C3 

C 

227 

343 

E3 

T 

196 

304 

C4 

D 

228 

344 

E4 

U 

197 

305 

C5 

E 

229 

345 

E5 

V 

198 

306 

C6 

F 

230 

346 

E6 

W 

199 

307 

C7 

G 

231 

347 

E7 

X 

200 

310 

C8 

H 

232 

350 

E8 

Y 

201 

311 

C9 

I 

233 

351 

E9 

Z 

202 

312 

CA 


234 

352 

EA 


203 

313 

CB 


235 

353 

EB 


204 

314 

CC 


236 

354 

EC 


205 

315 

CD 


237 

355 

ED 


206 

316 

CE 


238 

356 

EE 


207 

317 

CF 


239 

357 

EF 


208 

320 

DO 

} 

240 

360 

F0 

0 

209 

321 

D1 

J 

241 

361 

FI 

1 

210 

322 

D2 

K 

242 

362 

F2 

2 

211 

323 

D3 

L 

243 

363 

F3 

3 

212 

324 

D4 

M 

244 

364 

F4 

4 

213 

325 

D5 

N 

245 

365 

F5 

5 

214 

326 

D6 

0 

246 

366 

F6 

6 

215 

327 

D7 

P 

247 

367 

F7 

7 

216 

330 

D8 

Q 

248 

370 

F8 

8 

217 

331 

D9 

R 

249 

371 

F9 

9 

218 

332 

DA 


250 

392 

FA 


219 

333 

DB 


251 

373 

FB 


220 

334 

DC 


252 

374 

FC 


221 

335 

DD 


253 

375 

FD 


222 

336 

DE 


254 

376 

FE 


223 

337 

DF 


255 

377 

FF 



First Edition 


A-14 













MAGNET EDIT TOKENS 


BCD 


Decimal 

Octal 

Hex. 

Char. 

Decimal 

Octal 

Hex. 

Char. 

000 

000 

00 

blank 

024 

030 

18 

- 

001 

001 

01 

1 

025 

031 

19 

J 

002 

002 

02 

2 

026 

032 

1A 

K 

003 

003 

03 

3 

027 

033 

IB 

L 

004 

004 

04 

4 

028 

034 

1C 

M 

005 

005 

05 

5 

029 

035 

ID 

N 

006 

006 

06 

6 

030 

036 

IE 

0 

007 

007 

07 

7 

031 

037 

IF 

P 

008 

010 

08 

8 

032 

040 

20 

Q 

009 

Oil 

09 

9 

033 

041 

21 

R 

010 

012 

OA 

0 

034 

042 

22 

$ 

Oil 

013 

OB 

# 

035 

043 

23 

* 

012 

014 

OC 

@ 

036 

044 

24 

& 

013 

015 

OD 

/ 

037 

045 

25 

A 

014 

016 

OE 

S 

038 

046 

26 

B 

015 

017 

OF 

T 

039 

047 

27 

C 

016 

020 

10 

U 

040 

050 

28 

D 

017 

021 

11 

V 

041 

051 

29 

E 

018 

022 

12 

W 

042 

052 

2A 

F 

019 

023 

13 

X 

043 

053 

2B 

G 

020 

024 

14 

y 

044 

054 

2C 

H 

021 

025 

15 

z 

045 

055 

2D 

I 

022 

026 

16 

t 

046 

056 

2E 

• 

023 

027 

17 

) 

047 

057 

2F 

( 
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TRANSLATION TABLES 
BCD to Prime ASCII 

Binary 

10100000 10110001 
10110010 10110011 
10110100 10110101 
10110110 10110111 
10111000 10111001 
10110000 10100011 
11000000 10101111 
11010011 11010100 
11010101 11010110 
11010111 11011000 
11011001 11011010 
10101100 10101001 
10101101 11001010 
11001011 11001100 
11001101 11001110 
11001111 11010000 
11010001 11010010 
10100100 10101010 
10101011 11000001 
11000010 11000011 
11000100 11000101 
11000110 11000111 
11001000 11001001 
10101110 10101000 
10101001 10100101 
00000000 00000000 


Octal Decimal Hex. Characters 


120261 

41361 

A191 

space 1 

131263 

45747 

B2B3 

2 

3 

132265 

46261 

B4B5 

4 

5 

133267 

46775 

B6B7 

6 

7 

134271 

47289 

B8B9 

8 

9 

130243 

45219 

60A3 

0 

# 

140257 

49327 

C0AF 

@ 

/ 

151724 

54228 

D3D4 

S 

T 

152726 

54742 

D5D6 

U 

V 

153730 

55256 

D7D8 

W 

X 

154732 

55770 

D9DA 

Y 

Z 

126251 

44201 

ACA9 

f 

) 

126712 

44490 

ADCA 


J 

145714 

52172 

CBCC 

K 

L 

146716 

52686 

CDCE 

M 

N 

147720 

53200 

CFD0 

O 

P 

150722 

53714 

D1D2 

Q 

R 

122252 

42154 

A4AA 

$ 

* 

125701 

43969 

ABC1 

+ 

A 

141303 

49859 

C2C3 

B 

C 

142305 

50373 

C4C5 

D 

E 

143307 

50887 

C6C7 

F 

G 

144311 

51401 

C8C9 

H 

I 

127250 

44712 

AEA8 

• 

( 

124645 

43429 

A9A5 

) 

% 

000000 

00000 

0000 

(No lowercase or control 


characters. This line repeats 
104 additional times.) 
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MAGNET EDIT TOKENS 


Prime ASCII to BCD 

Binary 


Octal Decimal Hex, Characters 


00000000 

00000000 

000000 

00000 

0000 

(No lowercase or control 
characters. This line 
repeats 15 additional 
times.) 

00000000 

00001100 

000014 

00012 

oooc 

spc 

! 

00001100 

00001011 

006013 

03083 

0C0D 

IV 

# 

00101011 

00001100 

025414 

11020 

260C 

$ 

% 

00001100 

00001100 

006014 

03084 

ococ 

? 

i 

00111100 

00011100 

016074 

07228 

1C3C 

( 

) 

00101100 

00110000 

026060 

11312 

2C30 

* 

+ 

00011011 

00100000 

015440 

06944 

1B20 

f 

— 

00111011 

00010001 

035421 

15121 

3B11 

• 

/ 

00001010 

00000001 

005001 

02561 

0A01 

0 

1 

00000010 

00000011 

001003 

00515 

0203 

2 

3 

00000100 

00000101 

002005 

01029 

0405 

4 

5 

00000110 

00000111 

003007 

01543 

0607 

6 

7 

00001000 

00001001 

004011 

02057 

0809 

8 

9 

00001100 

00001100 

006014 

03084 

OCOC 

• 

• 

• 

i 

00001100 

00001100 

006014 

03084 

OCOC 

< 

= 

00001100 

00001100 

006014 

03084 

OCOC 

> 

? 

00000000 

00110001 

000061 

00049 

0031 

@ 

A 

00110010 

00110011 

031063 

12851 

3233 

B 

C 

00110100 

00110101 

032065 

13365 

3435 

D 

E 

00110110 

00110111 

033067 

13879 

3637 

F 

G 

00111000 

00111001 

034071 

14393 

3839 

H 

I 

00100001 

00100010 

020442 

08482 

2122 

J 

K 

00100011 

00100100 

021444 

08996 

2324 

L 

M 

00100101 

00100110 

022446 

09510 

2526 

N 

O 

00100111 

00101000 

023450 

10024 

2728 

P 

Q 

00101001 

00010010 

024422 

10514 

2912 

R 

S 

00010011 

00010100 

011424 

04884 

1314 

T 

u 

00010101 

00010110 

012426 

05398 

1516 

V 

w 

00010111 

00011000 

013430 

05912 

1718 

X 

Y 

00011001 

00001100 

014414 

06412 

190 C 

Z 

] 

00001100 

00001100 

006014 

03084 

OCOC 

\ 

t 

00001100 

00001100 

006014 

03084 

OCOC 

* 


00000000 

00000000 

000000 

00000 

0000 

(No lowercase or control 


characters. This line 
repeats 31 additional 
times.) 
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00000000 00000000 000000 00000 0000 (No lowercase or control 

characters. This line 
repeats 15 additional 


00000000 00001100 

000014 

00012 

oooc 

spc 

1 

00001100 00001011 

006013 

03083 

0C0D 

AT 

If 

# 

00101011 00001100 

025414 

11020 

260C 

$ 

% 

00001100 00001100 

006014 

03084 

ococ 

? 

1 

00111100 00011100 

016074 

07228 

1C3C 

( 

* 

f 

) 

+ 

00101100 00110000 
00011011 00100000 

026060 

015440 

11312 

06944 

2C30 

1B20 

00111011 00010001 

035421 

15121 

3B11 

• 

/ 

00001010 00000001 

005001 

02561 

0A01 

0 

1 

00000010 00000011 

001003 

00515 

0203 

2 

3 

00000100 00000101 

002005 

01029 

0405 

4 

5 

00000110 00000111 

003007 

01543 

0607 

6 

7 

00001000 00001001 

004011 

02057 

0809 

8 

9 

00001100 00001100 

006014 

03084 

OCOC 

• 

• 

• 

00001100 00001100 

006014 

03084 

OCOC 

< 

— 

00001100 00001100 

006014 

03084 

OCOC 

> 

? 

00000000 00110001 

000061 

00049 

0031 

@ 

A 

00110010 00110011 

031063 

12851 

3233 

B 

C 

00110100 00110101 

032065 

13365 

3435 

D 

E 

00110110 00110111 

033067 

13879 

3637 

F 

G 

00111000 00111001 

034071 

14393 

3839 

H 

I 

00100001 00100010 

020442 

08482 

2122 

J 

K 

00100011 00100100 

021444 

08996 

2324 

L 

M 

00100101 00100110 

022446 

09510 

2526 

N 

O 

00100111 00101000 

023450 

10024 

2728 

P 

Q 

00101001 00010010 

024422 

10514 

2912 

R 

S 

00010011 00010100 

011424 

04884 

1314 

T 

u 

00010101 00010110 

012426 

05398 

1516 

V 

W 

00010111 00011000 

013430 

05912 

1718 

X 

Y 

00011001 00001100 

014414 

06412 

190C 

Z 

] 

[ 

00001100 00001100 
00001100 00001100 

006014 

006014 

03084 

03084 

OCOC 

OCOC 

\ 

/s 

00000000 00000000 

000000 

00000 

0000 

(No lowercase or control 


characters. This line repeats 
31 additional times.) 
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MAGNET EDIT TOKENS 


Prime A SCII t o EBC DIC 


Binary 

Octal Decimal 

Hex. 

Positions 

Characters 

00000000 

00000001 

000001 

00001 

0001 

000 

001 

NUL 

SCH 

00000010 

00000011 

001003 

00515 

0203 

002 

003 

STX 

ETX 

00110111 

00101101 

033455 

14125 

372D 

004 

005 

EOT 

ENQ 

00101110 

00101111 

027057 

11823 

2E2F 

006 

007 

ACK 

BEL 

00010110 

00000101 

013005 

05637 

1605 

008 

009 

BS 

HT 

00100101 

00001011 

022413 

09483 

250B 

010 

Oil 

LF 

VT 

00001100 

00001101 

006015 

03085 

0C0D 

012 

013 

FF 

CR 

00001110 

00001111 

007017 

03599 

0E0F 

014 

015 

SO 

SI 

00010000 

00010001 

010021 

04113 

1011 

016 

017 

DLE 

DC1 

00010010 

01101111 

011157 

04719 

126F 

018 

019 

DC2 

? 

00111100 

00111101 

036075 

15421 

3C3D 

020 

021 

DC4 

NAK 

00110010 

00100110 

031046 

12838 

3226 

022 

023 

SYN 

ETB 

00011000 

00011001 

014031 

06169 

1819 

024 

025 

CAN 

EM 

00111111 

00100111 

037447 

16167 

3F27 

026 

027 

SUB 

ESC 

00011100 

00011101 

016035 

07197 

1C1D 

028 

029 

IFS 

IGS 

00011110 

00011111 

017037 

07711 

1E1F 

030 

031 

IRS 

IUS 

01000000 

01011010 

040132 

16474 

40 5A 

032 

033 

SP 

j 

01111111 

01111011 

077573 

32635 

7F7B 

034 

035 

II 

# 

01011011 

01101100 

055554 

23404 

5B6C 

036 

037 

$ 

% 

01010000 

01111101 

050175 

20605 

507D 

038 

039 

& 

1 

01001101 

01011101 

046535 

19805 

4D5D 

040 

041 

( 

) 

01011100 

01001110 

056116 

23 630 

5C4E 

042 

043 

* 

+ 

01101011 

01100000 

065540 

27488 

6B60 

044 

045 

f 

““ 

01001011 

01100001 

045541 

19297 

4B61 

046 

047 

• 

/ 

11110000 11110001 

170361 

61681 

F0F1 

048 

049 

0 

1 

11110010 

11110011 

171363 

62195 

F2F3 

050 

051 

2 

3 

11110100 

11110101 

172365 

62709 

F4F5 

052 

053 

4 

5 

11110110 

11110111 

173367 

63223 

F6F7 

054 

055 

6 

7 

11111000 

11111001 

174371 

63737 

F8F9 

056 

057 

8 

9 

01111010 

01011110 

075136 

31326 

7A5E 

058 

059 

• 

• 

• 

9 

01001100 

01111110 

046176 

19582 

4C7E 

060 

061 

< 

= 

01101110 

01101111 

067157 

28271 

6E6F 

062 

063 

> 

? 

01111100 

11000001 

076301 

31937 

7CC1 

064 

065 

@ 

A 

11000010 

11000011 

141303 

49859 

C2C3 

066 

067 

B 

C 

11000100 

11000101 

142305 

50373 

C4C5 

068 

069 

D 

E 

11000110 

11000111 

143307 

50887 

C6C7 

070 

071 

F 

G 

11001000 

11001001 

144311 

51401 

C8C9 

072 

073 

H 

I 

11010001 

11010010 

150722 

53714 

D1D2 

074 

075 

J 

K 

11010011 

11010100 

151724 

54228 

D3D4 

076 

077 

L 

M 

11010101 

11010110 

152726 

54742 

D5D6 

078 

079 

N 

O 

11010111 

11011000 

153730 

55256 

D7D8 

080 

081 

P 

Q 

11011001 

11100010 

154742 

55778 

D9E2 

082 

083 

R 

S 

11100011 

11100100 

161744 

58340 

E3E4 

084 

085 

T 

U 

11100101 

11100110 

162746 

58854 

E5E6 

086 

087 

V 

W 

11100111 

11101000 

163750 

593 68 

E7E8 

088 

089 

X 

Y 

11101001 

11000000 

164700 

59840 

E9C0 

090 

091 

Z 

{ 

11100000 

11010000 

160320 

57552 

E0D0 

092 

093 

\ 

} 

01011111 

01101101 

057555 

24429 

5F6D 

094 

095 

mr 

— 

01111001 

10000001 

074601 

31105 

7981 

096 

097 


a 
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10000010 10000011 
10000100 10000101 
10000110 10000111 
10001000 10001001 
10010001 10010010 
10010011 10010100 
10010101 10010110 
10010111 10011000 
10011001 10100010 
10100011 10100100 
10100101 10100110 
10100111 10101000 
10101001 11000000 
01101010 11010000 
10100001 00000111 
00000000 00000001 
00000010 00000011 
00110111 00101101 
00101110 00101111 
00010110 00000101 
00100101 00001011 
00001100 00001101 
00001110 00001111 
00010000 00010001 
00010010 01101111 
00111100 00111101 
00110010 00100110 
00011000 00011001 
00111111 00100111 
00011100 00011101 
00011110 00011111 
01000000 01011010 
01111111 01111011 
01011011 01101100 
01010000 01111101 
01001101 01011101 
01011100 01001110 
01101011 01100000 
01001011 01100001 
11110000 11110001 
11110010 11110011 
11110100 11110101 
11110110 11110111 
11111000 11111001 
01111010 01011110 
01001100 01111110 
01101110 01101111 
01111100 11000001 
11000010 11000011 
11000100 11000101 
11000110 11000111 
11001000 11001001 
11010001 11010010 


101203 33411 8283 098 099 b c 

102205 33925 8485 100 101 d e 

103207 34439 8687 102 103 f g 

104211 34953 8889 104 105 h i 

110622 37266 9192 106 107 j k 

111624 37780 9394 108 109 1 m 

112626 38294 9596 110 111 n o 

113630 38808 9798 112 113 p q 

114642 39330 99A2 114 115 r s 

121644 41892 A3A4 116 117 t u 

122646 42406 A5A6 118 119 v w 

123650 42920 A7A8 120 121 x y 

124700 43456 A9C0 122 123 z 

065320 27344 6AD0 124 125 | } 

120407 41223 A107 126 127 ~ DEL 

000001 00001 0001 128 129 NUL SCH 

001003 00515 0203 130 131 STX ETX 

033455 14125 372D 132 133 EOT ENQ 

027057 11823 2E2F 134 135 ACK BEL 

013005 05637 1605 136 137 BS HT 

022413 09483 250B 138 139 LF VT 

006015 03085 0C0D 140 141 FF CR 

007017 03599 OEOF 142 143 SO SI 

010021 04113 1011 144 145 DLE DC1 

011157 04719 126F 146 147 DC2 ? 

036075 15421 3C3D 148 149 DC4 NAK 

031046 12838 3226 150 151 SYN EIB 

014031 06169 1819 152 153 CAN EM 

037447 16167 3F27 154 155 SUB ESC 

016035 07197 1C1D 156 157 IFS IGS 

017037 07711 1E1F 158 159 IRS IUS 

040132 16474 405A 160 161 SP ! 

077573 32635 7F7B 162 163 " # 

055554 23404 5B6C 164 165 $ % 

050175 20605 507D 166 167 & ' 

046535 19805 4D5D 168 169 ( ) 

056116 23630 5C4E 170 171 * + 

065540 27488 6B60 172 173 , 

045541 19297 4B61 174 175 . / 

170361 61681 F0F1 176 177 0 1 

171363 62195 F2F3 178 179 2 3 

172365 62709 F4F5 180 181 4 5 

173367 63223 F6F7 182 183 6 7 

174371 63737 F8F9 184 185 8 9 

075136 31326 7A5E 186 187 : 

046176 19582 4C7E 188 189 < 

067157 28271 6E6F 190 191 > ? 

076301 31937 7CC1 192 193 @ A 

141303 49859 C2C3 194 195 B C 

142305 50373 C4C5 196 197 D E 

143307 50887 C6C7 198 199 F G 

144311 51401 C8C9 200 201 H I 

150722 53714 D1D2 202 203 J K 
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11010011 

11010100 

151724 

54228 

D3D4 

204 

205 

L 

M 

11010101 

11010110 

152726 

547 42 

D5D6 

206 

207 

N 

O 

11010111 

11011000 

153730 

55256 

D7D8 

208 

209 

P 

Q 

11011001 

11100010 

154742 

55778 

D9E2 

210 

211 

R 

S 

11100011 

11100100 

161744 

58340 

E3E4 

212 

213 

T 

U 

11100101 

11100110 

162746 

58854 

E5E6 

214 

215 

V 

w 

11100111 

11101000 

163750 

593 68 

E7E8 

216 

217 

X 

Y 

11101001 

11000000 

164700 

59840 

E9C0 

218 

219 

Z 

{ 

11100000 

11010000 

160320 

57552 

E0D0 

220 

221 

\ 

} 

01011111 

01101101 

057555 

24429 

5F6D 

222 

223 

NOT 

— 

01111001 

10000001 

074601 

31105 

7981 

224 

225 


a 

10000010 

10000011 

101203 

33411 

8283 

226 

227 

b 

c 

10000100 

10000101 

102205 

33925 

8485 

228 

229 

d 

e 

10000110 

10000111 

103207 

34439 

8687 

230 

231 

f 

g 

10001000 

10001001 

104211 

34953 

8889 

232 

233 

h 

i 

10010001 

10010010 

110622 

37266 

9192 

234 

235 

j 

k 

10010011 

10010100 

111624 

37780 

9394 

236 

237 

1 

m 

10010101 

10010110 

112626 

38294 

9596 

238 

23.9 

n 

o 

10010111 

10011000 

113630 

3 8808 

9798 

240 

241 

P 

q 

10011001 

10100010 

114642 

39330 

99A2 

242 

243 

r 

s 

10100011 

10100100 

121644 

41892 

A3A4 

244 

245 

t 

u 

10100101 

10100110 

122646 

42406 

A5A6 

246 

247 

V 

w 

10100111 

10101000 

123650 

42920 

A7A8 

248 

249 

X 

y 

10101001 

11000000 

124700 

43 456 

A9C0 

250 

251 

z 

{ 

01101010 11010000 

065320 

27344 

6AD0 

252 

253 

[ 

} 

10100001 

00000111 

120407 

41223 

A107 

254 

255 


DEL 
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EBCDIC to Prime ASCII 


18.4 

19.0 


Binary Octal Dec. 

10000000 10000001 100201 32897 
10000010 10000011 101203 33411 
10111111 10001001 137611 49033 

10111111 11111111 137777 49151 

10111111 10111111 137677 49087 

10111111 10001011 137613 49035 

10001100 10001101 106215 35981 
10001110 10001111 107217 36495 
10010000 10010001 110221 37009 
10010010 10111111 111277 37567 
10111111 10001010 137612 49034 
10001000 10111111 104277 35007 
10011000 10011001 114231 39065 
10111111 10111111 137677 49087 

10011100 10011101 116235 40093 
10011110 10011111 117237 40607 
10111111 10111111 137677 49087 

10111111 10111111 137677 49087 

10111111 10001010 137612 49034 
10010111 10011011 113633 38811 
10111111 10111111 137677 49087 

10111111 10111111 137677 49087 

10111111 10000101 137605 49029 
10000110 10000111 103207 34439 
10111111 10111111 137677 49087 
10010110 10111111 113277 38591 
10111111 10111111 137677 49087 

10111111 10000100 137604 49028 

10111111 10111111 137677 49087 

10111111 10111111 137677 49087 

10010100 10010101 112225 38037 
10111111 10011010 137632 49050 
10100000 10111111 120277 41151 
10111111 10111111 137677 49087 

10111111 10111111 137677 49087 

10111111 10111111 137677 49087 

10111111 10111111 137677 49087 

10111111 10101110 137656 49070 

10111100 10101000 136250 48296 
10101011 11111100 125774 44028 
10100110 10111111 123277 42687 
10111111 10111111 137677 49087 

10111111 10111111 137677 49087 

10111111 10111111 137677 49087 

10111111 10111111 137677 49087 

10100001 10100100 120644 41380 
10101010 10101001 125251 43689 
10111011 11011110 135736 48094 

10101101 10101111 126657 44463 


Hex. 

Positions 

ASCII Characters 

8081 

000 

001 

NUL 

SCH 

8283 

002 

003 

STX 

ETX 

BF89 

004 

005 

? 

HT 

BFFF 

006 

007 

? 

DEL 

BFBF 

008 

009 

? 

•? 

BF 8 B 

010 

Oil 

? 

VT 

8 C 8 D 

012 

013 

FF 

CR 

8 E 8 F 

014 

015 

SO 

SI 

9091 

016 

017 

DLE 

DC1 

92BF 

018 

019 

DC2 


BF 8 A 

020 

021 

? 

LF 

88 BF 

022 

023 

BS 

? 

9899 

024 

025 

CAN 

EM 

BFBF 

026 

027 

? 

? 

9C9D 

028 

029 

FS 

GS 

9E9F 

030 

031 

RS 

US 

BFBF 

032 

033 

? 

? 

BFBF 

034 

035 

•? 

• 


BF 8 A 

036 

037 

? 

LF 

97 9B 

038 

039 

ETB 

ESC 

BFBF 

040 

041 

7 

? 

BFBF 

042 

043 

7 

? 

BF85 

044 

045 

7 

ENQ 

8687 

046 

047 

ACK 

BEL 

BFBF 

048 

049 

7 

? 

96BF 

050 

051 

SYN 

? 

BFBF 

052 

053 

7 

? 

BF84 

054 

055 

7 

EOT 

BFBF 

056 

057 

7 

? 

BFBF 

058 

059 

7 

? 

9495 

060 

061 

DC4 

NAK 

BF9A 

062 

063 

7 

SUB 

AOBF 

064 

065 

SP 

? 

BFBF 

066 

067 

7 

9 

BFBF 

068 

069 

7 

? 

BFBF 

070 

071 

7 

? 

BFBF 

072 

073 

7 

? 

BFAE 

074 

075 

7 

• 

BCA 8 

076 

077 

< 

( 

ABPC 

078 

079 

+ 

| 

A 6 BF 

080 

081 

& 

7 

BFBF 

082 

083 

7 

7 

BFBF 

084 

085 

7 

7 

BFBF 

086 

087 

7 

7 

BFBF 

088 

089 

7 

7 

A1A4 

090 

091 

! 

$ 

AAA9 

092 

093 

* 

) 

BBDE 

094 

095 

• 

t 

ys 

ADAF 

096 

097 

- 

/ 





First Edition, Update 1 


A-22 













MAGNET EDIT TOKENS 


10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

11111100 10101100 176254 

10100101 11011111 122737 

10111110 10111111 137277 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 11100000 137740 

10111010 10100011 135243 

11000000 10100111 140247 

10111101 10100010 136642 

10111111 11100001 137741 

11100010 11100011 161343 

11100100 11100101 162345 

11100110 11100111 163347 

11101000 11101001 164351 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 11101010 137752 

11101011 11101100 165754 

11101101 11101110 166756 

11101111 11110000 167760 

11110001 11110010 170762 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 11111110 137776 

11110011 11110100 171764 

11110101 11110110 172766 

11110111 11111000 173770 

11111001 11111010 174772 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

10111111 10111111 137677 

11111011 11000001 175701 

11000010 11000011 141303 

11000100 11000101 142305 

11000110 11000111 143307 

11001000 11001001 144311 

10111111 10111111 137677 


49087 

BFBF 

098 

099 

? 

49087 

BFBF 

100 

101 

? 

49087 

BFBF 

102 

103 

? 

49087 

BFBF 

104 

105 

? 

64684 

FCAC 

106 

107 

i 

42463 

A5DF 

108 

109 


48831 

BEBF 

no 

111 

> 

49087 

BFBF 

112 

113 

? 

49087 

BFBF 

114 

115 

7 

49087 

BFBF 

116 

117 

7 

49087 

BFBF 

118 

119 

7 

49120 

BFEO 

120 

121 

9 

• 

47779 

BAA3 

122 

123 

• 

• 

49319 

C0A7 

124 

125 

@ 

48546 

BDA2 

126 

127 


49121 

BFEl 

128 

129 

7 

58083 

E2E3 

130 

131 

b 

58597 

E4E5 

132 

133 

d 

59111 

E6E7 

134 

135 

f 

59625 

E8E9 

136 

137 

h 

49087 

BFBF 

138 

139 

7 

49087 

BFBF 

140 

141 

7 

49087 

BFBF 

142 

143 

7 

49130 

BFEA 

144 

145 

7 

60396 

EBEC 

146 

147 

k 

60910 

EDEE 

148 

149 

m 

61424 

EFF0 

150 

151 

o 

61938 

F1F2 

152 

153 

q 

49087 

BFBF 

154 

155 

7 

49087 

BFBF 

156 

157 

7 

49087 

BFBF 

158 

159 

7 

49150 

BFFE 

160 

161 

7 

62452 

F3F4 

162 

163 

s 

62966 

F5F6 

164 

165 

u 

63480 

F7F8 

166 

167 

w 

63994 

F9FA 

168 

169 

y 

49087 

BFBF 

170 

171 

7 

49087 

BFBF 

172 

173 

7 

49087 

BFBF 

174 

175 

7 

49087 

BFBF 

176 

177 

7 

49087 

BFBF 

178 

179 

7 

49087 

BFBF 

180 

181 

7 

49087 

BFBF 

182 

183 

7 

49087 

BFBF 

184 

185 

7 

49087 

BFBF 

186 

187 

7 

49087 

BFBF 

188 

189 

7 

49087 

BFBF 

190 

191 

9 

• 

64449 

FBC1 

192 

193 

{ 

49859 

C2C3 

194 

195 

B 

50373 

C4C5 

196 

197 

D 

50887 

C6C7 

198 

199 

F 

51401 

C8C9 

200 

201 

H 

49087 

BFBF 

202 

203 

? 


? 

? 

? 

? 

r 


9 

? 

? 

? 

? 

\ 

# 

I 


a 

c 

e 


? 

? 

? 

? 

? 

? 

? 

? 

? 

? 

A 

C 

E 

G 

I 

? 
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10111111 10111111 
10111111 10111111 
11111101 11001010 
11001011 11001100 
11001101 11001110 
11001111 11010000 
11010001 11010010 
10111111 10111111 
10111111 10111111 
10111111 10111111 
11011100 10111111 
11010011 11010100 
11010101 11010110 
11010111 11011000 
11011001 11011010 
10111111 10111111 
10111111 10111111 
10111111 10111111 
10110000 10110001 
10110010 10110011 
10110100 10110101 
10110110 10110111 
10111000 10111001 
11111100 10111111 
10111111 10111111 
10111111 10111111 


137677 

49087 

BFBF 

137677 

49087 

BFBF 

176712 

64970 

FDCA 

145714 

52172 

CBCC 

146716 

52686 

CDCE 

147720 

53 200 

CFDO 

150722 

53714 

D1D2 

137677 

49087 

BFBF 

137677 

49087 

BFBF 

137677 

49087 

BFBF 

156277 

56511 

DCBF 

151724 

54228 

D3D4 

152726 

54742 

D5D6 

153730 

55256 

D7D8 

154732 

55770 

D9EA 

137677 

49087 

BFBF 

137677 

49087 

BFBF 

137677 

49087 

BFBF 

130261 

45233 

B0B1 

131263 

45747 

B2B3 

132265 

46261 

B4B5 

133267 

46775 

B6B7 

134271 

47289 

B8B9 

176277 

64703 

FCBF 

137677 

49087 

BFBF 

137677 

49087 

BFBF 


204 205 ? ? 

206 207 ? ? 

208 209 } J 

210 211 K L 

212 213 M N 

214 215 0 P 

216 217 Q R 

218 219 ? ? 

220 221 ? ? 

222 223 ? ? 

224 225 \ ? 

226 227 S T 

228 229 U V 

23 0 231 W X 

232 233 Y Z 

234 235 ? ? 

23 6 237 ? ? 

23 8 239 ? ? 

240 241 0 1 

242 243 2 3 

244 245 4 5 

246 247 6 7 

248 249 8 9 

250 251 | ? 

252 253 ? ? 

254 255 ? ? 


First Edition, Update 1 


A-24 





magnet edit tokens 


Industry-standard ASCII to Prime ASCII 

Binary Octal Decimal Hex. Characters 


10000000 10000001 

100201 

32897 

8081 

NUL 

SCH 

10000010 10000011 

101203 

33411 

8283 

STX 

ETX 

10000100 10000101 

102205 

33925 

8485 

EOT 

ENQ 

10000110 10000111 

103207 

34439 

8687 

ACK 

BEL 

10001000 10001001 

104211 

34953 

8889 

BS 

HT 

10001010 10001011 

105213 

35467 

8A8B 

LF 

VT 

10001100 10001101 

106215 

35981 

8C8D 

FF 

CR 

10001110 10001111 

107217 

36495 

8E8F 

SO 

SI 

10010000 10010001 

110221 

37009 

9091 

DLE 

DC1 

10010010 10010011 

111223 

37523 

9293 

DC2 

DC3 

10010100 10010101 

112225 

38037 

9495 

DC4 

NAK 

10010110 10010111 

113227 

38551 

9697 

SYN 

ETB 

10011000 10011001 

114231 

39065 

9899 

CAN 

EM 

10011010 10011011 

115233 

39579 

9A9B 

SUB 

ESC 

10011100 10011101 

116235 

40093 

9C9D 

FS 

GS 

10011110 10011111 

117237 

40607 

9E9F 

RS 

US 

10100000 10100001 

120241 

41121 

A0A1 

sp 

! 

10100010 10100011 

121243 

41635 

A2A3 

If 

# 

10100100 10100101 

122245 

42149 

A4A5 

$ 

% 

10100110 10100111 

123247 

42663 

A6A7 

& 

1 

10101000 10101001 

124251 

43177 

A8A9 

( 

) 

10101010 10101011 

125253 

43691 

AAAB 

* 

+ 

10101100 10101101 

126255 

44205 

ACAD 

r 

— 

10101110 10101111 

127257 

44719 

AEAF 

• 

/ 

10110000 10110001 

130261 

45233 

B0B1 

0 

1 

10110010 10110011 

131263 

45747 

B2B3 

2 

3 

10110100 10110101 

132265 

46261 

B4B5 

4 

5 

10110110 10110111 

133267 

46775 

B6B7 

6 

7 

10111000 10111001 

134271 

47289 

B8B9 

8 

9 

10111010 10111011 

135273 

47803 

BABB 

• 

• 

• 

i 

10111100 10111101 

136275 

48317 

BCBD 

< 

= 

10111110 10111111 

137277 

48831 

bebf 

> 

? 

11000000 11000001 

140301 

49345 

C0C1 


A 

11000010 11000011 

141303 

49859 

C2C3 

B 

C 

11000100 11000101 

142305 

50373 

C4C5 

D 

E 

11000110 11000111 

143307 

50887 

C6C7 

F 

G 

11001000 11001001 

144311 

51401 

C8C9 

H 

I 

11001010 11001011 

145313 

51915 

CACB 

J 

K 

11001100 11001101 

146315 

52429 

cccd 

L 

M 

11001110 11001111 

147317 

52943 

CECF 

N 

0 

11010000 11010001 

150321 

53457 

D0D1 

P 

Q 

11010010 11010011 

151323 

53971 

D2D3 

R 

S 

11010100 11010101 

152325 

54485 

D4D5 

T 

U 

11010110 11010111 

153327 

54999 

D6D7 

V 

W 

11011000 11011001 

154331 

55513 

D8D9 

X 

Y 

11011010 11011011 

155333 

56027 

DADB 

Z 

[ 

11011100 11011101 

156335 

56541 

DCDD 

\ 

] 

11011110 11011111 

157337 

57055 

DEDF 


___ 

11100000 11100001 

160341 

57569 

EX) El 


a 
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11100010 

11100100 

11100110 

11101000 

11101010 

11101100 

11101110 

11110000 

11110010 

11110100 

11110110 

11111000 

11111010 

11111100 

11111110 

10000000 

10000010 

10000100 

10000110 

10001000 

10001010 

10001100 

10001110 

10010000 

10010010 

10010100 

10010110 

10011000 

10011010 

10011100 

10011110 

10100000 

10100010 

10100100 

10100110 

10101000 

10101010 

10101100 

10101110 

10110000 

10110010 

10110100 

10110110 

10111000 

10111010 

10111100 

10111110 

11000000 

11000010 

11000100 

11000110 

11001000 

11001010 


11100011 
11100101 
11100111 
11101001 
11101011 
11101101 
11101111 
11110001 
11110011 
11110101 
11110111 
11111001 
union 
11111101 
11111111 
10000001 
10000011 
10000101 
10000111 
10001001 
10001011 
10001101 
10001111 
10010001 
10010011 
10010101 
10010111 
10011001 
10011011 
10011101 
10011111 
10100001 
10100011 
10100101 
10100111 
10101001 
10101011 
10101101 
10101111 
10110001 
10110011 
10110101 
10110111 
10111001 
10111011 
10111101 
10111111 
11000001 
11000011 
11000101 
11000111 
11001001 
11001011 


161343 
162345 
163347 
164351 
165353 
166355 
167357 
170361 
171363 
172365 
173367 
174371 
175373 
176375 
177377 
100201 
101203 
102205 
103207 
104211 
105213 
106215 
107217 
110221 
111223 
112225 
113227 
114231 
115233 
116235 
117237 
120241 
121243 
122245 
123247 
124251 
125253 
126255 
127257 
130261 
131263 
132265 
133267 
134271 
135273 
136275 
137277 
140301 
141303 
142305 
143307 
144311 
145313 


58083 

E2E3 

b 

c 

58597 

E4E5 

d 

e 

59111 

E6E7 

f 

g 

59625 

E8E9 

h 

i 

60139 

EAEB 

j 

k 

60653 

ECED 

1 

m 

61167 

EKBk 

n 

o 

61681 

F0F1 

p 

q 

62195 

F2F3 

r 

s 

62709 

F4F5 

t 

u 

63223 

F6F7 

V 

w 

63737 

F8F9 

X 

y 

64251 

FAFB 

z 

{ 

64765 

FCFD 

] 

} 

65279 

FEFF 


DEL 

32897 

8081 

NUL 

SCH 

33411 

8283 

STX 

EIX 

33925 

8485 

EOT 

ENQ 

34439 

8687 

ACK 

BEL 

34953 

8889 

BS 

HT 

35467 

8A8B 

LF 

VT 

35981 

8C8D 

FF 

CR 

36495 

8E8F 

SO 

SI 

37009 

9091 

DLE 

DC1 

37523 

9293 

DC2 

DC3 

38037 

9495 

DC4 

NAK 

38551 

9697 

SYN 

EIB 

39065 

9899 

CAN 

EM 

39579 

9A9B 

SUB 

ESC 

40093 

9C9D 

FS 

GS 

40607 

9E9F 

RS 

US 

41121 

AOAl 

sp 

i 


42149 

42663 

43177 

43691 

44205 

44719 

45233 

45747 

46261 

46775 

47289 

47803 

48317 

48831 

49345 

49859 

50373 

50887 

51401 

51915 


A4A5 
A6A7 
A8A9 
AAAB 
ACAD 
AEAF 
B0B1 
B2B3 
B4B5 
B6B7 
B8B9 8 
BABB : 
BCBD < 
BEEF > 
C0C1 @ 
C2C3 B 
C4C5 D 
C6C7 F 
C8C9 H 
CACB J 


# 

% 

V 

) 

+ 

/ 

1 

3 

5 

7 

9 


? 

A 

C 

E 

G 

I 

K 
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11001100 11001101 146315 
11001110 11001111 147317 
11010000 11010001 150321 
11010010 11010011 151323 
11010100 11010101 152325 
11010110 11010111 153327 
11011000 11011001 154331 
11011010 11011011 155333 
11011100 11011101 156335 
11011110 11011111 157337 
11100000 11100001 160341 
11100010 11100011 161343 
11100100 11100101 162345 
11100110 11100111 163347 
11101000 11101001 164351 
11101010 11101011 165353 
11101100 11101101 166355 
11101110 11101111 167357 
11110000 11110001 170361 
11110010 11110011 171363 
11110100 11110101 172365 
11110110 11110111 173367 
11111000 11111001 174371 
11111010 11111011 175373 
11111100 11111101 176375 
11111110 11111111 177377 


52429 

CCCD 

L 

M 

52943 

CECF 

N 

0 

53457 

D0D1 

P 

Q 

53971 

D2D3 

R 

S 

54485 

D4D5 

T 

U 

54999 

D6D7 

V 

W 

55513 

D8D9 

X 

y 

56027 

DADE 

Z 

[ 

56541 

DCDD 

\ 

] 

57055 

DEDF 

St 

_ 

57569 

E0E1 

% 

a 

58083 

E2E3 

b 

c 

58597 

E4E5 

d 

e 

59111 

E6ET7 

f 

g 

59625 

E8E9 

h 

i 

60139 

EAEB 

j 

k 

60653 

ECED 

1 

m 

61167 

EEEF 

n 

o 

61681 

F0F1 

P 

q 

62195 

F2F3 

r 

s 

62709 

F4F5 

t 

u 

63223 

F6F7 

V 

w 

63737 

F8F9 

X 

y 

64251 

FAFB 

z 

{ 

64765 

FCFD 

1 

} 

65279 

FEFF 

** 

DEL 
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Prime ASCII to Industry-standard ASCII 

B ircr Y Octal Decimal Hex. Characters 


00000000 00000001 000001 
00000010 00000011 001003 
00000100 00000101 002005 
00000110 00000111 003007 
00001000 00001001 004011 
00001010 00001011 005013 
00001100 00001101 006015 
00001110 00001111 007017 
00010000 00010001 010021 
00010010 00010011 011023 
00010100 00010101 012025 
00010110 00010111 013027 
00011000 00011001 014031 
00011010 00011011 015033 
00011100 00011101 016035 
00011110 00011111 017037 
00100000 00100001 020041 
00100010 00100011 021043 
00100100 00100101 022045 
00100110 00100111 023047 
00101000 00101001 024051 
00101010 00101011 025053 
00101100 00101101 026055 
00101110 00101111 027057 
00110000 00110001 030061 
00110010 00110011 031063 
00110100 00110101 032065 
00110110 00110111 033067 
00111000 00111001 034071 
00111010 00111011 035073 
00111100 00111101 036075 
00111110 00111111 037077 
01000000 01000001 040101 
01000010 01000011 041103 
01000100 01000101 042105 
01000110 01000111 043107 
01001000 01001001 044111 
01001010 01001011 045113 
01001100 01001101 046115 
01001110 01001111 047117 
01010000 01010001 050121 
01010010 01010011 051123 
01010100 01010101 052125 
01010110 01010111 053127 
01011000 01011001 054131 
01011010 01011011 055133 
01011100 01011101 056135 
01011110 01011111 057137 
01100000 01100001 060141 


00001 

0001 

NUL 

SCH 

00515 

0203 

STX 

ETX 

01029 

0405 

EOT 

ENQ 

01543 

0607 

ACK 

BEL 

02057 

0809 

BS 

HT 

02571 

0A0B 

LF 

VT 

03085 

0C0D 

FF 

CR 

03599 

0E0F 

SO 

SI 

04113 

1011 

DLE 

DC1 

04627 

1213 

DC2 

DC3 

05141 

1415 

DC4 

NAK 

05655 

1617 

SYN 

ETB 

06169 

1819 

CAN 

EM 

06683 

1A1B 

SUB 

ESC 

07197 

1C1D 

FS 

GS 

07711 

1E1F 

RS 

US 

08225 

2021 

sp 

I 

08739 

2223 

H 

# 

09253 

2425 

$ 

% 

09767 

2627 

& 

1 

10281 

2829 

( 

) 

10795 

2A2B 

* 

+ 

11309 

2C2D 

f 

— 

11823 

2E2F 

• 

/ 

12337 

3031 

0 

1 

12851 

3233 

2 

3 

13365 

3435 

4 

5 

13879 

3637 

6 

7 

14393 

3839 

8 

9 

14907 

3A3B 

• 

• 

# 

15421 

3C3D 

< 


15935 

3E3F 

> 

? 

16449 

4041 

@ 

A 

16963 

4243 

B 

C 

17477 

4445 

D 

E 

17991 

4647 

F 

G 

18505 

4849 

H 

I 

19019 

4A4B 

J 

K 

19533 

4C4D 

L 

M 

20047 

4E4F 

N 

0 

20561 

5051 

P 

Q 

21075 

5253 

R 

S 

21589 

5455 

T 

U 

22103 

5657 

V 

w 

22617 

5859 

X 

Y 

23131 

5A5B 

Z 

[ 

23645 

24159 

5C5D 

5E5F 

\ 

/V 

] 

24673 

6061 


a 
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magnet edit tokens 


01100010 01100011 061143 
01100100 01100101 062145 
01100110 01100111 063147 
01101000 01101001 064151 
01101010 01101011 065153 
01101100 01101101 066155 
01101110 01101111 067157 
01110000 01110001 070161 
01110010 01110011 071163 
01110100 01110101 072165 
01110110 01110111 073167 
01111000 01111001 074171 
01111010 01111011 075173 
01111100 01111101 076175 
01111110 01111111 077177 
00000000 00000001 000001 
00000010 00000011 001003 
00000100 00000101 002005 
00000110 00000111 003007 
00001000 00001001 004011 
00001010 00001011 005013 
00001100 00001101 006015 
00001110 00001111 007017 
00010000 00010001 010021 
00010010 00010011 011023 
00010100 00010101 012025 
00010110 00010111 013027 
00011000 00011001 014031 
00011010 00011011 015033 
00011100 00011101 016035 
00011110 00011111 017037 
00100000 00100001 020041 
00100010 00100011 021043 
00100100 00100101 022045 
00100110 00100111 023047 
00101000 00101001 024051 
00101010 00101011 025053 
00101100 00101101 026055 
00101110 00101111 027057 
00110000 00110001 030061 
00110010 00110011 031063 
00110100 00110101 032065 
00110110 00110111 033067 
00111000 00111001 034071 
00111010 00111011 035073 
00111100 00111101 036075 
00111110 00111111 037077 
01000000 01000001 040101 
01000010 01000011 041103 
01000100 01000101 042105 
01000110 01000111 043107 
01001000 01001001 044111 
01001010 01001011 045113 


25187 

6263 

b 

c 

25701 

6465 

d 

e 

26215 

6667 

f 

g 

26729 

6869 

h 

i 

27243 

6A6B 

j 

k 

27757 

6C6D 

1 

m 

28271 

6E6F 

n 

o 

28785 

7071 

P 

q 

29299 

7273 

r 

s 

29813 

7475 

t 

u 

30327 

7677 

V 

w 

30841 

7879 

X 

y 

31355 

7A7B 

z 

{ 

31869 

7C7D 

1 

} 

32383 

7ET7F 


DEL 

00001 

0001 

NUL 

SCH 

00515 

0203 

STX 

ETX 

01029 

0405 

EOT 

enq 

01543 

0607 

ACK 

BEL 

02057 

0809 

BS 

HT 

02571 

0A0B 

LF 

VT 

03085 

OCOD 

FF 

CR 

03599 

OEOF 

SO 

SI 

04113 

1011 

DLE 

DC1 

04627 

1213 

DC2 

DC3 

05141 

1415 

DC4 

NAK 

05655 

1617 

SYN 

ETB 

06169 

1819 

CAN 

EM 

06683 

1A1B 

SUB 

ESC 

07197 

1C1D 

FS 

GS 

07711 

1E1F 

RS 

US 

08225 

2021 

sp 

! 

08739 

2223 

n 

# 

09253 

2425 

$ 

% 

09767 

2627 

& 

1 

10281 

2829 

( 

) 

10795 

2A2B 

* 

+ 

11309 

2C2D 

r 

- 

11823 

2E2F 

• 

/ 

12337 

3031 

0 

1 

12851 

3233 

2 

3 

13365 

3435 

4 

5 

13879 

3637 

6 

7 

14393 

3839 

8 

9 

14907 

3A3B 

• 

• 

i 

15421 

3C3D 

< 

ss 

15935 

3E3F 

> 

? 

16449 

4041 

@ 

A 

16963 

4243 

B 

C 

17477 

4445 

D 

E 

17991 

4647 

F 

G 

18505 

4849 

H 

I 

19019 

4A4B 

J 

K 
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01001100 01001101 

046115 

19533 

4C4D 

L 

M 

01001110 01001111 

047117 

20047 

4E4F 

N 

o 

01010000 01010001 

050121 

20561 

5051 

P 

Q 

01010010 01010011 

051123 

21075 

5253 

R 

s 

01010100 01010101 

052125 

21589 

5455 

T 

u 

01010110 01010111 

053127 

22103 

5657 

V 

w 

01011000 01011001 

054131 

22617 

5859 

X 

Y 

01011010 01011011 

055133 

23131 

5A5B 

z 

[ 

] 

a 

01011100 01011101 

056135 

23645 

5C5D 

\ 

01011110 01011111 
01100000 01100001 

057137 

060141 

24159 

24673 

5E5F 

6061 

* 

01100010 01100011 

061143 

25187 

6263 

b 

c 

01100100 01100101 

062145 

25701 

6465 

d 

e 

01100110 01100111 

063147 

26215 

6667 

f 

g 

01101000 01101001 

064151 

26729 

6869 

h 

i 

01101010 01101011 

065153 

27243 

6A6B 

j 

k 

01101100 01101101 

066155 

27757 

6C6D 

1 

m 

01101110 01101111 

067157 

28271 

6E6F 

n 

o 

01110000 01110001 

070161 

28785 

7071 

p 

q 

01110010 01110011 

071163 

29299 

7273 

r 

s 

01110100 01110101 

072165 

29813 

7475 

t 

u 

01110110 01110111 

073167 

30327 

7677 

V 

w 

01111000 01111001 
01111010 01111011 

074171 

075173 

30841 

31355 

7879 

7A7B 

X 

z 

y 

{ 

} 

DEL 

01111100 01111101 

076175 

31869 

7C7D 

1 

01111110 01111111 

077177 

32383 

7E7F 
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B 

Command 
Line Options 
and Batch Jobs 


While invoking MAGNET, there are severed command line options you can 
specify. The -SILENT option disables the printing of Severity 1 
messages. (See Chapter 7 for detailed information on MAGNET messages.) 
The -USER and -OPERATOR (or -OPR) options specify where MOUNT and 
DISMOUNT messages are printed. -USER causes these messages to be 
printed on your terminal. -OPERATOR (or -OPR) causes them to be 
printed on the operator's console. 

All MOUNT and DISMOUNT messages require a reply from either you or the 
operator. At the operator's console, the reply takes the form of the 
REPLY command. (See Chapter 5.) The operator, however, should not use 
the following form of the REPLY command: 

REPLY -usrnum -TAPE pdn 
Acceptable forms for the operator are: 

REPLY -usrnum -TAPE GO 
or 

REPLY -usrnum -TAPE ABORT 
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After you receive a MOUNT or DISMOUNT message and a prompt (>) at your 
terminal, your reply should be one of the following: 

> REPLY -TAPE GO 

or 

> REPLY -TAPE ABORT 

Any other response causes the MOUNT or DISMOUNT message to be repeated. 

The default communication mode is -OPERATOR. Directing messages and 
replies to the operator's console rather than your input command stream 
allows you to build prepackaged magnetic tape jobs that you can run 
under BATCH. These jobs can be run at any time, with tape mount and 
dismount instructions submitted to an operator prior to execution. 
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c 

MAGNET 
Additional 
Features and 
Notes 


PRE-REV 18.3 MAGNET 

The pre-Rev 18.3 functionality of MAGNET is still supported. The four 
subcommands that still accept interactive dialog are: 

Subcommand Function 

POSITION Positions the tape to a file/record. 

READ Reads a file from tape to disk. 

WRITE Writes a file to tape from disk. 

COPY Copies a file from one tape to another. 


The POSITION Subcommand 

The POSITION subcommand positions the magnetic tape to a specific file 
and record number. POSITION has two modes, absolute and relative . An 
absolute position causes the tape to be rewound before any spacing 
occurs. A relative position allows the tape to be moved forward or 
backward from the current position. 

When you give the POSITION subcommand, MAGNET reguests a magnetic tape 
unit number. The response is an integer in the range 0 to 7, 
optionally followed by a /7 or /9 to indicate a seven- or nine-track 
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transport. The default is nine-track. MAGNET then asks whether this 
is an absolute or relative position. Finally, the file and record 
numbers are requested. If you specify an absolute position, the file 
and record numbers are absolute (starting with 1), and must be 
positive. In relative mode, the file number represents the number of 
files to space forward or backward and may be positive or negative. 
The record number is the number of records to space forward or backward 
and must be greater than or equal to 0. An example of a typical 
POSITION operation is as follows: 


OK, MAGNET 
[MAGNET, rev. 18.3] 

> POSITION 
MTU # = 0 

Relative or absolute? ABSOLUTE 
File # = 23 
Record # = 271 

> 


The READ Subcommand 

The READ subcommand allows a file to be read from a magnetic tape and 
written to disk. It also provides optional unblocking and EBCDIC or 
BCD translation. 

The READ subcommand requests the unit number, which you must enter in 
the format described under the POSITION subcommand. You then enter the 
magnetic tape file number, which must be a positive integer. If this 
number is greater than 0, the tape is rewound and positioned to the 
specified file number. If the file number is 0, the tape is not 
rewound. 

The next series of questions in the READ subcommand dialog relates to 
the format of the data on the magnetic tape file to be read. The 
logical record size is the number of bytes in.each logical record. The 
blocking factor is the number of logical records (line images) 
contained in one physical tape record. MAGNET then asks you for the 
fype °f translation, and you provide one of the following responses: 

ASCII Specifies no translation between tape and disk. MAGNET 
writes the data to the disk file in Prime ASCII. 

EBCDIC Instructs MAGNET to translate the data on the tape from 
EBCDIC to Prime ASCII before writing it to the disk file. 

BCD Instructs MAGNET to translate the data from BCD (six-bit) 

to Prime ASCII before writing it to the disk file. This 
option is only useful for seven-track tapes. 
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BINARY Instructs MAGNET to write the data verbatim to a binary 
disk file. The record size is the specified logical 
record size. Packing or unpacking only occurs if you are 
using a seven-track tape. 


If you specify either EBCDIC or BCD translation, MAGNET asks if the 
entire record is to be translated or only selected fields. This 
permits bypassing translation of binary fields in EBCDIC records 
(output, for example, by COBOL). For partial record translation, 
MAGNET requests starting and ending column numbers of the data to be 
translated. This input is terminated with a null line (CR only). 
Finally, MAGNET requests the disk output filename. The following is an 
example of a typical READ procedure: 


OK, MAGNET 
[MAGNET, rev. 18.3] 


> READ 
MTU # = 0 
File # = 1^ 

Logical record length = 80 

Blocking factor = 10 

ASCII, EBCDIC, BCD or BINARY? EBCDIC 

Full or partial record translation? PARTIAL 

Enter pairs of starting/ending column numbers, one pair per line. 
Separate each column number with a comma. Terminate entry with a 
null line (carriage-return) only. 

10,25 

35,50 

DISK”file: FILE.INPUT 

> 


The WRITE Subcommand 

The WRITE subcommand is similar to the READ subcommand, except that the 
file on disk is written to the magnetic tape. WRITE also provides 
facilities for blocking and character translation. 

The WRITE subcommand first asks for the magnetic tape unit and file 
numbers, and then for information on how the data format is to appear 
on the tape. As for the READ subcommand, you must specify the logical 
record size and the blocking factor. You must also provide the type of 
translation, if any. You specify one of the following options: 

ASCII Specifies no translation. 

EBCDIC Specifies EBCDIC translation onto tape. 

BCD Specifies BCD translation onto tape. 

BINARY Specifies a binary file. 
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enH ?!! S C1 ? EBCD; ? C ? r 5(35 translation, MAGNET asks whether the 

SSSTgo^rTTs ** “«*• * * " 


OK, MAGNET 
[MAGNET, rev. 18.3] 

> READ 

mnr= o 

File # =~1 

Logical record length = 60 
Blocking factor = 20 
ASCII, EBCDIC, BCD or BINARY? ASCII 
Disk file: SUEFILE - 

> 


The COPY Subcommand 

me core suboon^nd copies a file (or files) from one magnetic tape to 
another. No character translation is provided. The maqnetictane 
transports may be either seven- or nine-track. magnetic tape 

mo^requests the prom and TO tape units, starting file numbers, and 
t , of files to copy. To copy an entire tape* you must enter a 
large number. (EOT is detected and causes the copy operation to halt ) 
The following is an example of a typical COPY proSduiS: ° 


OK, MAGNET 
[MAGNET, rev. 18.3] 

> COPY 

*** "FROM" tape information: *** 
MTU # = 2 

Starting file # = 5 

*** "to" tape information: *** 

MTU # = 6 

Starting file # = 9 

# of files to copy = 27 
Print record sizes? NO 

> — 
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MAGNET ADDITIONAL FEATURES 


Notes on Pre-Rev 18.3 Features 

• All interactive commands now return to MAGNET subcommand level, 
not to PRIMOS level as in the pre-Rev 18.3 software. You must 
use the QUIT subcommand to return to PRIMUS command level. 

• Pre-Rev 18.3 MAGNET printed messages indicating completion of 
READ, WRITE, COPY, or POSITION operations. New MAGNET does not 
print these messages. 

• When EOT is detected, the new MAGNET REPLY mechanism is now 
used. In addition, all MOUNT and DISMOUNT messages are directed 
to the operator's console unless you explicitly use the -USER 
command line option. 

• MAGNET now retries all I/O operations up to 10 times in case of 
error. Prior to Rev 18.3, MAGNET indicated that an error had 
occurred and whether or not it was a recoverable error. New 
MAGNET does not supply you with this information. In addition, 
all error messages have changed. (See Chapter 7.) 

• It is recommended that you modify any existing command or CPL 
files to take advantage of the new MAGNET subcommands. The old 
(pre-Rev 18.3) subcommand forms are provided for compatibility 
only. 


ADDITIONAL NOTES 

• User labels are not yet supported. 

• In the new forms of the READ, WRITE, and MOVE subcommands, the 
default translation code used is Prime ASCII to industry 
standard ASCII for output, and industry standard ASCII to Prime 
ASCII for input. The default trahslation is Prime ASCII to 
Prime ASCII for both input and output when you use the old forms 
of the READ and WRITE subconmands. 

• Physical record lengths (IRECL * BFACPOR) should be at least 20 
characters. 

* 

• ACCESS codes are recognized, but are not processed or verified. 

• Pre-Rev 18.3 MAGNET did not write a filemarker after EOT was 
detected. This functionality was nonstandard. New MAGNET does 
write this filemarker on output, and expects to read it on 
input. Therefore, some tapes may be incompatible between the 
old and new versions of MAGNET. 
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• TO read information from a tape verbatim, specify: 

FORMAT= (VAR/PRIME) for your source tape; 

FORMAT=(FIXED) for your destination disk file? 

(0*) translation for your source tape; 

LRECL=(the-same-large-number) for both source and destination; 

and use the MOVE subcommand. 

• Use ASSIGN commands with -TP3D options to get the first tapes 
mounted prior to invoking MAGNET. 

• DISMOUNT messages repeat until a tape drive is offline and not 
ready. MOUNT messages repeat until a tape drive is both online 
and ready. 

• Use the LABEL command to initialize a tape (see Chapter 6) prior 
to using labelled tape features within MAGNET. 

• For MAGNET messages 152 and 153 (see Chapter 7) r check for tape 
drives not assigned, powered-down, not ready, or offline. 

• The best value to specify for the BUFFERS option is 3. A larger 
number will probably not produce any increase in speed. In 
fact, speed may decrease due to the larger amounts of storage 
accessed. 

• Do not specify a BUFFERS option for the second or later objects 
in a chain. (For more information, see the descriptions of the 
EREVCHAIN and NEXTCHAIN options in Chapter 7.) Buffers that 
belong to the first object are reused for later objects. 

• Tape objects should be reused for multiple tape files. in 
addition to opening files on tapes, MAGNET requires that the 
tapes themselves be opened. If you use several objects 
specifying different files on the same tape, the tape is rewound 
each time you specify a different object within a READ, WRITE, 
or MOVE subcommand. It is better, therefore, to use the MODIFY 
subcommand to change filenames or numbers prior to using 
different data transferral subcommands. 

• All subcommands may be abbreviated to the first letter(s) of the 
subcommand. Thus, POSITION could be abbreviated to P, PO, BOS, 
etc. LIST may be abbreviated to L, but LOAD may not be 
abbreviated shorter than LO. DECLARE may be abbreviated to DEC 
only. (An allowed alternative abbreviation for DECLARE is DCL.) 
DELETE may be abbreviated to D. DISPLAY may be abbreviated to 
DI. MOVE may be abbreviated to MOV, while MODIFY may only be 
abbreviated to MOD. Finally, READ may be abbreviated to R, 
while RENAME can only be abbreviated to REN. You cannot 
abbreviate options or option values. The one exception to this 
rule, however, is the response to the "ABSOLUTE OR RELATIVE?" 
question within the old form (pre-Rev 18.3) of the POSITION 
subcommand. In this case, you may respond with A or R. 
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. * repetition factor A-5, A-6 

/* (comment), MAGNET subcommand 
7-38 

-1600 BPI f ASSIGN option 4-3 

-6250 BPI, ASSIGN option 4-3 

-7TRK option: 
in ASSIGN 4-3 
in MAGRST 8-5, 8-6 
in MAGSAV 8-2 

-800 BPI f ASSIGN option 4-3 

-9TRK, ASSIGN option 4-3 

Abbreviations of MAGNET 
subcommands C-6 

ABORT 5-4 

ABSOLUTE C-6 

Absolute position C-l f C-2 


Absolute positioning 7-37 

-ACCESS, LABEL option 6-1, 6-2 

ACCESS, MAGNET option 
7-43, 7-44 

Advanced MAGNET 7-38 to 7-51 

Advanced MAGNET subcommand 
options: 

ACCESS 7-43, 7-44 
CHARACTERS 7-46 to 7-48 
CREATE 7-44, 7-45 
EXCHANGE 7-47, 7-49 
EXPIRE 7-44, 7-45 
EXTERNAL 7-39 to 7-41 
GENERATION 7-45 
LINES 7-51 
MAXIO 7-50 
NEXTCHAIN 7-42, 7-43 
OFFSET 7-45 
POSTACTION 7-41, 7-42 
PREACTION 7-41, 7-42 

PREVCHAIN 7-42, 7-43 

SEQUENCE 7-46 
TYPE 7-51 
VERSION 7-45 
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ANSI standard labels 
3-1 to 3-3, 3-5 to 3-7, 3-9 

ANSI standard spanned 
variable-length records 2-5, 

2-6, 2-11 

ANSI standard variable-length 
records 2-2, 2-4 

ASCII 1-10, 1-11 

ASCII to Prime ASCII 
A-25 to A-27 

ASCII: 

character set 2-7 
industry-standard A-l, A-2, 
C-3, C-5 

industry-standard table 
A-7, A-8 

Prime A-l, A-2, A-3, A-5, 
C-2, C-5 

Prime table A-9, A-10 

ASSIGN command options: 

-1600 BPI 4-3 

-6250 BPI 4-3 

-7TRK 4-3 
-800 BPI 4-3 
-91RK 4-3 

-ALIAS MTlch 4-2 
-MDUNT 4-3 4-5 
—MTpdn 4-2 

-MTX 4-2 
-RINGOFF 4-3 
-RINGCN 4-3 
-TPID 4-5 C-6 
-TPID id 4-3 
-WAIT 4-2 4-4 

ASSIGN: 

command 4-1 to 4-6, 

5-1 to 5-4 

command line format 4-2 
command messages 4-5, 4-6 

Assigning tape drives by: 
logical device number 
4-3 to 4-5 

physical device number 4-3, 
4-4 


Badspots 9-15 to 9-17, 9-4, 
9-9 


BATCH jobs with magnetic tapes 
B-2 


BCD 1-10, C-2 to C-4 

BCD table A-15 

BCD to Prime ASCII translation 
table A-16 

BCDIC 1-10, 1-11, A-2 

BCW 2-2 

Beginning-of-file label group 
3-6 

Beginning-of-tape marker 1-8 

BFACTOR, MAGNET option 
7-6, 7-11 

BFACTOR, MAGNET option, 
diagranmed 7-12, 7-13 

BINARY C-3 

Binary packing/unpacking 1-11 

Binary packing/unpacking, 
diagrammed 1-12 

Binary tapes: 

IBM System 360/370 2-7 

Prime 2-7 

Bit settings: 

in PHYSAV and PHYRST messages 
9-7 

Bits 1-2 
Bits per inch 1-2 
Block control word 2-2 
Blocking 1-4 
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Blocking factor 1-4, 02 
BOT 1-8 
bpi 1-2 

Break format 2-6 

BUFFERS, MAGNET Option 7-25 

BYPASS, MAGNET option 7-25 

Bytes 1-10 

Capstan 1-8 

Channels 1-2 

Character codes: 

ASCII 1-10, 1-11 
BCD 1-10 
BCDIC 1-10, 1-11 
defined 1-10 
EBCDIC 1-10, 1-11 
Prime ASCII 1-10 

Character set tables 
A-6 to A-30 

Characters per inch 1-2 

CHARACTERS, MAGNET option 
7-46 to 7-48 

CHARACTERS, MAGNET option, 
diagrammed 7-48 

Characters: 
fill A-3 

Codes: 

packing A-4 

Column position edit token A-2 
Command line format: 


ASSIGN 

4-2 

label 

6-1 

MAGNET 

7-2 

MAGRST 

8-5 

MAGSAV 

8-1 

PHYRST 

9-14 


PHYSAV 9-2 
REPLY 5-4 
SETM0D 5-2 
STATUS DEVICE 4-9 
UNASSIGN 4-7 

Command line options, MAGNET: 
-OPERATOR 7-2, B-l, B-2 
-SILENT 7-2, B-l 
-USER 7-2, B-l, C-5 

Commands: 

ASSIGN 4-1 to 4-6, 

5-1 to 5-4, C-6 
LABEL 6-1 to 6-6, C-6 

REPLY 4-5, 5-1 to 5-5, B-l 

SETMOD 4-7, 5-1 to 5-3 
STATUS DEVICE 4-9, 5-1 
UNASSIGN 4-1, 4-6 to 4-8, 5-1 

Comment (/*) MAGNET subcommand 
7-38 

Configurations, diagrammed: 
tape label and file 
3-12 to 3-15 
unlabelled tape file 
3-16 to 3-20 

Control word: 
block 2-2 
record 2-2 

COPY: 

MAGNET subcommand 7-35 
pre-Rev 18.3 C-4 

subcommand line format 7-35 

cpi 1-2 

CREATE, MAGNET option 
7-44, 7-45 

Data transferral subcommands 
7-33 to 7-35 

DECLARE: 

abbreviation C-6 
MAGNET subcommand 7-3 
subcommand line format 7-3 
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DELETE: 

abbreviation C-6 
subcommand 7-30 
subcommand line format 7-30 

Deletion edit token A-3 

DENSITY, MAGNET Option 7-11 

Density, tape 1-2 

Destination-object-name 7-35 

DEVICE 4-9 

Device number: 

logical 4-2 to 4-5, 4-7, 4-9, 
8-6 

physical 4-2 to 4-4, 4-7, 

4-9, 5-2, 5-4, 8-6, 9-3, 9-15 

Dialog: 

MAGRST 8-6 to 8-8 
MAGSAV 8-3, 8-4 
PHYRST 9-14, 9-15 
FHYSAV 9-2 to 9-4 

DISK, MAGNET option 7-6 

DISMOUNT messages 7-2, 

B-l, B-2, C-6 

DISPLAY: 

abbreviation C-6 

MAGNET subcommand 7-26, 7-27 

subcommand line format 7-26 

Drive, tape 1-8 

Drive, tape (diagrammed) 1-9 

DUMPED switch 8-2 

EBCDIC 1-10, 1-11, A-3, 

C-2 to C-4 

EBCDIC table A-ll to A-14 

EBCDIC to Prime ASCII 
translation table 
A-22 to A-24 


Edit token A A-l 

Edit token B A-2 

Edit token C A-2 

Edit token D A-3 

Edit token E A-3 

Edit token F A-3, A-4 

Edit token list 7-31 

Edit token 0 A-5 

Edit token P A-5 

Edit tokens G through N A-4 

Edit tokens Q through U A-5 

Edit tokens V through Z A-5 

Edit tokens: 

in MAGNET 7-30 to 7-32 
table of 7-32 
translation of A-l to A-6 

End-of-file label group 3-11 

End-of-tape marker 1-8 

EOF1 3-11 

EOF2 3-11 

EOF3-EOF9 3-11 

EOFn 3-1 

EOT 1-8 

EOV1 3-11 

EOV2 3-11 

EOVn 3-1, 3-2, 3-11 

EXCHANGE, MAGNET option 
7-47, 7-49 
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EXCHANGE, MAGNET option, 
diagrammed 7-49 

EXPIRE, MAGNET option 
7-44, 7-45 

External features of a tape 
reel, diagrammed 7-24 

EXTERNAL, MAGNET option 
7-39 to 7-41 


File header label group 3-6, 
3-11 

File header labels ( See Header 

labels) 

File marker gaps 1-6 

File markers 1-6 

File, tape 1-6 

FILE3D, MAGNET option 
7-17, 7-22 

FILENO, MAGNET option 
7-17, 7-22 

Fill characters A-3 

Fixed-length records: 
defined 1-4, 2-1 
diagrammed 1-5 
standard 2-2 

FORMAT, MAGNET option 7-14 

FORMAT, MAGNET option, 
diagrammed 7-15 

Formats, label and tape file 
( See Tape label and file 
configurations) 

Formats, unlabelled tape file 
( See Unlabelled tape file 
configurations) 


Frame, tape 1-2 
Gaps: 

file marker 1-6 
inter-record 1-4, 1-8 

GCR 1-8 

GENERATION, MAGNET option 7-45 
Global variables 7-39, 7-40 
GO 5-4 

Group code recording 1-8 

HDR1 3-7, 3-8 

HDR2 3-9, 3-10 

HDRn 3-1, 3-6 

Header labels: 
defined 3-2 
HDRl 3-7, 3-8 

HDR2 3-9, 3-10 

HDRn 3-1, 3-6 

UHLn 3-1, 3-2, 3-5, 3-6 

Heads, read/write 1-8 

Hubs 1-8 

IBM binary tapes 2-7 

IBM format tapes 2-6, 2-7 

IBM labels 6-1 to 6-4 

IBM segment control codes 2-10, 
2-5 


IBM segment control word 2-5, 
2-9 


IBM standard labels 3-1, 3-2, 
3-4 to 3-6, 3-8, 3-10 

IBM standard spanned 
variable-length records 2-5, 

2-8 
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IBM standard variable-length 
records 2-2, 2-3 

id 4-3 

-INC, MAGSAV option 8-2 

Inches per second 1-8 

Industry-standard ASCII 
A-l, A-2, C-3, C-5 

Industry-standard ASCII table 
A-7, A-8 

Industry-standard ASCII to Prime 
ASCII translation table 
A-25 to A-27 

-INIT, LABEL option 6-1, 6-2 

Inter-record gaps 1-4, 1-8, 

8-2 

ips 1-8 

IRGs ( See Inter-record gaps) 

Jobs, BATCH, with magnetic tapes 
B-2 

Label and tape file formats 
( See Tape label and file 
configurations) 

LABEL command messages: 

PRIMOS errors 6-5, 6-6 

syntax errors 6-3 to 6-5 

LABEL command options: 

-ACCESS 6-1, 6-2 
-INIT 6-1, 6-2 
-OWNER 6-1, 6-2 
-TYPE 6-1, 6-2 
-VOL 6-2 
-VQLID 6-1, 6-2 
-VOLSER 6-1, 6-2 

-VOLUME 6-1, 6-2 

Label group: 
beginning-of-file 3-6 
defined 3-11 


end-of-file 3-11 
file header 3-6, 3-11 
volume header 3-2, 3-11 

LABEL: 

command 6-1 to 6-6, C-6 
command line format 6-1 

Labelled tapes 3-1 to 3-16, 
3-12 to 3-15 

LABELS, MAGNET option 7-16 
Labels: 

ANSI 6-1, 6-2 

ANSI standard 3-1 to 3-3, 

3-5 to 3-7, 3-9 
header 3-1, 3-2, 

3-5 to 3-9, 3-10 
IBM 6-1 to 6-4 
IBM standard 3-1, 3-2, 

3-4 to 3-6, 3-8, 3-10 
Level 1 3-11 

Level 2 3-11 

Level 3 3-11 

trailer 3-1, 3-2, 3-5, 3-11 

types of 3-1 

volume 3-1 to 3-5, 3-11 

LDEVICE 4-9 

ldn ( See Logical device number) 

Level 1 labels 3-11 

Level 1 tape 3-11 

Level 2 labels 3-11 

Level 2 tape 3-11 

Level 3 labels 3-11 

Level 3 tape 3-11 

Level 4 tape 3-11 

LEVEL, MAGNET Option 7-16, 7-17 

LEVEL, MAGNET option, diagrammed 
7-18 to 7-21 
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LINES, MAGNET option 7-51 
LIST: 

abbreviation C-6 
subcommand 7-26 
subcommand line format 7-26 

LOAD: 

abbreviation C-6 

MAGNET subcommand 7-50, 7-51 

subcommand line format 7-51 

Logical device number: 
assigning tape drives by 
4-3 to 4-5, 4-9 


defined 4-2 

in MAGRST dialog 

8-6 

in MAGSAV dialog 

8-3 

unassigning tape drives by 

4-7 

Logical record 1-4, 

, 2-5, 2-6 

Logical record size 

C-2 

Logical tape format 

1-6 

Logical tape format. 

diagrammed 

1-7 

-LONG, MAGSAV option 

8-2 

LRECL, MAGNET option 

7-6, 7-11 


LRECL, MAGNET option, diagrammed 
7-12, 7-13 


MAGNET subcommand options: 
ACCESS 7-43, 7-44 
AMOUNT 7-35, 7-36 
BFACTOR 7-6, 7-11 
BFACTOR, diagrammed 
7-12, 7-13 
BUFFERS 7-25 
BYPASS 7-25 
CHARACTERS 7-46 to 7-48 
CREATE 7-44, 7-45 
DENSITY 7-11 
DISK 7-6 

EXCHANGE 7-47, 7-49 
EXPIRE 7-44, 7-45 
EXTERNAL 7-39 to 7-41 


FILEID 7-17 
FILENO 7-17, 7-22 
FORMAT 7-14 
FORMAT, diagrammed 7-15 
GENERATION 7-45 
LABELS 7-16 
LEVEL 7-16, 7-17 
LEVEL, diagrammed 
7-18 to 7-21 
LINES 7-51 
LRECL 7-6, 7-11 
LRECL, diagrammed 7-12, 7-13 
MAXIO 7-50 
MODE 7-37 

NEXTCHAIN 7-42, 7-43 
OFFSET 7-45 
OWNER 7-22 
PARITY 7-14, 7-16 
POSTACTION 7-41, 7-42 
PREACTION 7-41, 7-42 
PREVCHAIN 7-42, 7-43 
PRINT 7-36 
PROTECT 7-16 
RECORDNO 7-23 
SEQUENCE 7-46 
table of 7-7 to 7-10 
TAPE 7-6 
TRACKS 7-11 
TYPE 7-51 
VERSION 7-45 
VISUAL 7-23 
VCLSER 7-22, 7-23 

MAGNET: 

additional features and notes 
C-l to C-6 

advanced 7-38 to 7-51 
facilities provided by 
7-1, 7-2 
invoking 7-2 
messages 7-55 to 7-80 
Pre-Rev 18.3 features 
C-l to C-6 

sample session 7-53 to 7-55 
subcommand line format 7-2 
subcommands 7-26 to 7-38, 

7-3 to 7-5 

types of messages 7-55, 7-56 
Magnetic spots 1-2 
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Magnetic tape standards 
2-6 to 2-13 

Magnetic tapes: 
physical characteristics of 
1 - 1 f 1-2 

MAGRST command options: 

-7TRK 8-5, 8-6 
-TTY 8-6 

MAGRST: 

command line format 8-5 
dialog 8-6 to 8-8 
messages 8-9 to 8-14 
sample session 8-8, 8-9 
subsystem 8-1, 8-5 to 8-14 

MAGSAV command options: 

-7TRK 8-2 
-INC 8-2 
-LONG 8-2 
-TTY 8-2 
-UPDT 8-2 
-VAR 8-2 

MAGSAV: 

command line format 8-1 
dialog 8-3, 8-4 
messages 8-9 to 8-14 
sample session 8-4, 8-5 
subsystem 8-1 to 8-5, 

8-9 to 8-14 

Marker: 

beginning-of-tape 1-8 
end-of-tape 1-8 
file 1-6 
tape 1-6 

MAXIO, MAGNET option 7-50 


Messages: 


ASSIGN 

4-5, 4-6 

DISMOUNT 7-2, B-l, B-2, 

LABEL 

6-3 to 6-6 

MAGNET 

7-55 to 7-80 

MAGRST 

8-9 to 8-14 

MAGSAV 

8-9 to 8-14 

MOUNT 

7-2, B-l, B-2, C- 

PHYRST 

9-17 to 9-20 

PHYSAV 

9-5 to 9-13 


REPLY 5-5 
SETMOD 5-2, 5-3 
UNASSIGN 4-8 

MODE, MAGNET option 7-37 

MODIFY: 

abbreviation C-6 

MAGNET subcommand 7-28, 7-29 

subcommand line format 7-28 

MOUNT messages 7-2, B-l, B-2, 
C-6 

MOUNT REPLY mechanism C-5 
-MOUNT, ASSIGN option 4-3, 4-5 
Mounting tapes 4-5 
MOVE: 

abbreviation of C-6 
MAGNET subcommand 7-34 
subcommand line format 7-34 

MTpdn 4-2 

MTX 4-2 

Multiple files, multiple reels 
3-15, 3-20 

Multiple files, single reel 
3-14, 3-18 

Multiple reels, multiple files 
3-15, 3-20 

Multiple reels, single file 
3-13, 3-19 

NEXTCHAIN, MAGNET option 
7-42, 7-43 

Nine-track tape: 
defined 1-2 
diagrammed 1-3 
parity of 1-10 

No assignment mode 5-1, 5-2 
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-NOASSIGN, SETMOD option 5-2 
Non-return to zero inverted 1-8 
NRZI 1-8 

Object-name 7-26, 7-3, 7-35, 
7-37 

Off-line 4-7 

OFFSET, MAGNET option 7-45 

Operator mode 5-1, 5-2 

-OPERATOR, MAGNET option 
7-2, B-l, B-2 

-OPERATOR, SETMOD option 5-2 

-OPR (See -OPERATOR, MAGNET 
option) 

-OWNER, LABEL Option 6-1, 6-2 

OWNER, MAGNET option 7-22 

Packing codes A-4 

Packing/unpacking, binary 1-11 

Packing/unpacking, binary 
(diagramed) 1-12 

Parity bit 1-10 

Parity track 1-10 

PARITY, MAGNET option 
7-14, 7-16 

Partition 9-1, 9-2, 9-4 
pdn 4-2 
PE 1-8 

Phase-encoded 1-8 
PHYRST: 

bit settings in messages 9-7 
command line format 9-14 


command option 9-14 
dialog 9-14, 9-15 
messages 9-17 to 9-20 
reentering 9-16 
sample session 9-16, 9-17 
subsystem 9-1, 9-14 to 9-20 

PHYSAV: 

bit settings in messages 9-7 
command line format 9-2 
command option 9-2 
dialog 9-2, 9-3, 9-3, 9-4 
messages 9-5 to 9-13 
reentering 9-4 
sample session 9-5 
subsystem 9-1 to 9-13 

Physical block 2-6 

Physical device number: 
assigning tape drives by 4-3, 
4-4, 4-9, 5-2, 5-4 
defined 4-2 
in MAGRST dialog 8-6 

in MAGSAV dialog 8-3 

in PHYRST dialog 9-15 

in PHYSAV dialog 9-3 

unassigning tape drives by 
4-7 

Ply si cal record 1-4, 2-6 

POSITION: 

abbreviations C-6 
MAGNET subcommand 7-37 
pre-Rev 18.3 C-l, C-2 
subcommand line format 7-37 

Positioning, absolute 7-37, 

C-l, C-2 

Positioning, relative 7-37, 

C-l, C-2 

POSTACTION, MAGNET option 
7-41, 7-42 

Postamble 1-4, 1-8 

POSTION subcommand: 
modes C-l, C-2 
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Pre-Rev 18.3 MAGNET C-l to C-6 

PREACTION, MAGNET option 
7-41, 7-42 

Preamble 1-4, 1-8 

PREVCHAIN, MAGNET option 
7-42, 7-43 

Prime ASCII 1-10, A-l to A-3, 
A-5, C-2, C-5 

Prime ASCII table A-9, A-10 

Prime ASCII to BCD translation 
table A-17, A-18 

Prime ASCII to EBCDIC 
translation table 
A-19 to A-21 

Prime ASCII to industry-standard 
ASCII translation table 
A-28 to A-30 

Prime binary tapes 2-7 

Prime variable-length format 
2-6 

PRINT, MAGNET option 7-36 

PROTECT, MAGNET option 7-16 

QUIT: 

MAGNET subcommand 7-38 
pre-Rev 18.3 C-4 

subcommand line format 7-38 

RAT ( See Record availability 
table) 

RCW 2-2 

Read/write heads 1-8 

READ: 

abbreviation C-6 
MAGNET subcommand 7-33 
pre-Rev 18.3 C-2, C-3 

subcommand line format 7-33 


Record availability table 
9-6 to 9-8, 9-11 

Record availability table (RAT) 
9-2, 9-3 

Record control word 2-2 
RECORDNO, MAGNET option 7-23 
Records: 

fixed-length 1-4, 2-1, 2-2 
fixed-length, diagramed 1-5 
logical 1-4, 2-5, 2-6 
physical 1-4 

spanned variable-length 2-5, 

2-6, 2-8 

variable-length 2-1 to 2-6, 
2-8 

Reel, tape (diagram of external 
features) 7-24 

Reel: 

physical characteristics of 
1-2 

supply 1-8 
take-up 1-8 

Relative positioning 7-37, 

C-l, C-2 

REN 9-16 

RENAME: 

abbreviation C-6 

MAGNET subcommand 7-27, 7-28 

subcommand line format 7-27 

-REPEAT, REPLY option 5-4 

Repetition factor * A-5 

REPLY command options: 

ABORT 5-4 
-ALL 5-4 
GO 5-4 
-REPEAT 5-4 
-RESEND 5-4 
-TAPE 5-4 


First Edition 


INDEX-10 


Settings, tape density 4-3 


REPLY: 

command 4-5, 5-1, 5-2, 

5-3 to 5-5, Br-1 
command line format 5-4 
command message 5-5 

-RESEND, REPLY option 5-4 

RINGOFF 4-3 

RINGON 4-3 

SAVE: 

MAGNET subcommand 7-50 
subcommand line format 7-50 

SCC ( See Segment control codes) 

SCW ( See Segment control word) 


Segment 

2-5, 2-6 

Segment 

control codes: 

ANSI 

2-13, 2-6 

IBM 

2-10, 2-5 

Segment 

control word: 

ANSI 

2-12, 2-5, 2-6 

IBM 

2-5, 2-9 

Segment 

descriptor 2-! 


SEQUENCE, MAGNET option 7-46 

SETMOD command modes: 
no assignment 5-1, 5-2 
operator 5-1, 5-2 
user (default) 5-1, 5-2 

SE7M0D command options: 
-NOASSIGN 5-2 
-OPERATOR 5-2 
-USER 5-2, 5-3 

SETMOD: 

command 4-7, 5-1 to 5-3 
command line format 5-2 
command message 5-3 
console messages 5-2, 5-3 


Seven-track tape: 
defined 1-2 
diagrammed 1-3 
parity of 1-10 

Severity 1 MAGNET message 7-55 

Severity 2 MAGNET message 7-56 

Severity 3 MAGNET message 7-56 

-SILENT, MAGNET option 7-2, B-l 

Single file, multiple reels 
3-13, 3-19 

Single reel, multiple files 
3-14, 3-18 

Single reel, single file 3-12, 

3-17 

Source-object-name 7-35 

Spanned records: 

variable-length 2-5, 2-8 

Speed, tape drive 1-8 

Standards: 

magnetic tape 2-6 to 2-13 

STATUS DEVICE: 

command 4-9, 5-1 
coirmand line format 4-9 

Subcommand line format: 

/* 7-38 

COPY 7-35 
DECLARE 7-3 
DELETE 7-30 
DISPLAY 7-26 
LIST 7-26 
LOAD 7-51 
MAGNET 7-2 
MODIFY 7-28 
MOVE 7-34 
POSITION 7-37 
QUIT 7-38 
READ 7-33 
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RENAME 7-27 
SAVE 7-50 
TRANSLATE 7-30 
WRITE 7-33 

Subcommand options: 

MAGNET 7-6 to 7-25 

table of MAGNET 7-7 to 7-10 

Subcommands, advanced MAGNET: 
LOAD 7-50, 7-51 
SAVE 7-50 

Subcommands: 

/* (comment) 7-38 
abbreviations for C-6 

additional MAGNET 7-37, 7-38 

OOPy 7-35, O-l, C-4 
data transferral 7-33 to 7-35 
DECLARE 7-3, C-6 
DELETE 7-30, C-6 
DISPLAY 7-26, 7-27, C-6 
LIST 7-26, C-6 
LOAD C-6 

MAGNET 7-26 to 7-38, 

7- 3 to 7-5 

MODIFY 7-28, 7-29, C-6 
MOVE 7-34, C-6 
POSITION 7-37, O-l, C-2, C-6 
QUIT 7-38, C-6 

READ 7-33, O-l, C-2, C-3, C-6 

RENAME 7-27, 7-28, C-6 
TRANSLATE 7-30, 7-31, A-l 
WRITE 7-33, 7-34, 

O-l, C-3, C-4 

Subsystems: 

MAGNET 7-1, 7-2 
MAGRST 8-1, 8-5 to 8-14 

MAGSAV 8-1 to 8-5, 

8- 9 to 8-14, 8-4 
PHYRST 9-1, 9-14 to 9-20 
PHYSAV 9-1 to 9-13 

Supply reel 1-8 

Swapping bytes in MAGNET 7-47 

Tables: 

BCD A-15 

character set A-6 to A-30 
EBCDIC A-ll to A-14 


industry-standard ASCII 
A-7, A-8 

Prime ASCII A-9, A-10 
translation A-16 to A-30 

Take-up reel 1-8 

TAPE 5-4 

Tape character 1-2 

Tape density settings 4-3 

Tape drive, described 1-8, 1-9 

Tape drive, diagrammed 1-9 

Tape drives, assigning by: 
logical device number 
4-3 to 4-5 

physical device number 4-3, 
4-4 

Tape drives, unassigning by: 
logical device number 4-7 
physical device number 4-7 

Tape file 1-6 

Tape format, logical 1-6 

Tape format, logical 
(diagrammed) 1-7 

Tape frame 1-2 

Tape label and file 
configurations, diagrams 
3-12 to 3-15 

Tape marker 1-6, 2-7 

Tape reel: 

external features, diagrammed 
7-24 

TAPE, MAGNET option 7-3, 7-6 
Tape: 

positioning 7-37 
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Tapes: 

density of 1-2 

labelled 3-1 to 3-16 

Level 1 3-11 

Level 2 3-11 

Level 3 3-11 

Level 4 3-11 

nine-track 1-10, 1-2 

nine-track, diagrammed 1-3 

seven-track 1-10, 1-2 

seven-track, diagrammed 1-3 

unlabelled 3-16 to 3-20 

Tokens, edit A-l to A-6 

-TPID, ASSIGN option 4-3, 4-5, 
C-6 

Tracks 1-2 

TRACKS, MAGNET option 7-11 

Trailer labels: 
defined 3-2 
E0F1 3-11 
E0F2 3-11 
EOF3-EOF9 3-11 
EOFn 3-1 

UTLn 3-1, 3-2, 3-5, 3-11 
TRANSLATE: 

MAGNET subcommand 7-30, 7-31 
subcommand line format 7-30 
used with edit tokens 
A-l to A-6 

Translation edit tokens, table 
of 7-32 

Translation tables: 

BCD to Prime ASCII A-16 
creating 7-52, 7-53 
EBCDIC to Prime ASCII 
A-22 to A-24 

Prime ASCII to BCD A-17, A-l8 
Prime ASCII to EBCDIC 
A-19 to A-21 
Prime ASCII to 

industry-standard ASCII 
A-28 to A-30 


-TTy option: 
in MAGRST 8-6 

in MAGSAV 8-2 

-TYPE, LABEL option 6-1 

TYPE, MAGNET option 7-51 

UHLn 3-1, 3-2, 3-5, 3-6 

UNASSIGN command options: 

-ALIAS 4-7 
-ALIAS ldn 4-7 
-UNLOAD 4-7 

UNASSIGN: 

command 4-1, 4-6 to 4-8, 5-1 
command line format 4-7 
command messages 4-8 

Unassigning tape drives by: 
logical device number 4-7 
physical device number 4-7 

Unlabelled tape file formats 
( See Unlabelled tape file 
configurations) 

Unlabelled tapes 3-16 to 3-20 

-UNLOAD, UNASSIGN option 4-7 

-UNMDD option: 
in PHYRST 9-14 
in PHYSAV 9-2 

-UPDT, MAGSAV option 8-2 

User (default) mode, in ASSIGN 
5-1 to 5-3 

-USER option: 

in MAGNET 7-2, B-l, C-5 
in SETMDD 5-2 

USENAM 4-9 

USENUM 4-9 

UTLn 3-1, 3-2, 3-5, 3-11 
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UVLn 3-1, 3-2 

Vacuum chamber 1-8 

-VAR, MAGSAV option 8-2 

Variable-length records: 

MSI standard 2-2, 2-4 
MSI standard spanned 2-5, 
2-6, 2-11 
defined 2-1 
IBM standard 2-2, 2-3 
IBM standard spanned 2-5, 2-8 
Prime 2-6 

Variables, global 7-39, 7-40 
VERSION, MAGNET option 7-45 
VISUAL, MAGNET option 7-23 
-VCL, LABEL option 6-2 
VCLl 3-3, 3-4 
V0L2-VCL9 3-5 

-VOLID, LABEL option 6-1, 6-2 
VOLn 3-1, 3-2 

-VOLSER, LABEL option 6-1, 6-2 

Volume header label group 3-2, 
3-11 


Volume labels EDVn 3-2 

Volume labels: 
defined 3-1 
E0V1 3-11 

EOV2 3-11 

EOVn 3-1, 3-2, 3-11 

UVLn 3-1, 3-2, 3-5 

VOLl 3-3, 3-4 

VCL2-V0L9 3-5 
VCLn 3-1, 3-2 

-VOLUME, LABEL option 6-1, 6-2 


-WAIT, ASSIGN option 4-2, 4-4 

Write-enable ring, use of with 
ASSIGN 1-2, 4-1, 4-3 

Write-enable ring, with PHYSAV 
9-12 

WRITE: 

MAGNET subcommand 7-33, 7-34 
pre-Rev 18.3 0-1, C-3, C-4 

subcommand line format 7-33 
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* repetition factor A-5, A-6 

/* (comment), MAGNET subcommand 
7-42 

7TRK option: 
in ASSIGN 4-4 

in MAGRST 8-5, 8-6 

in MAGSAV 8-2 

9TRK, ASSIGN option 4-4 

Abbreviations of MAGNET 
subcommands C-6 

ABORT 5-4 

ABSOLUTE C-6 

Absolute position 0-1, C-2 
Absolute positioning 7-41 

ACCESS, LABEL option 6-1, 6-2 

ACCESS, MAGNET option 7-49 
Advanced MAGNET 7-42 to 7-62 


Advanced MAGNET subcommand 
options: 

ACCESS 7-49 
CHARACTERS 7-52 
CREATE 7-49, 7-50 
EXCHANGE 7-52, 7-53 
EXPIRE 7-49, 7-50 
EXTERNAL 7-43 to 7-45 
GENERATION 7-50, 7-51 
LINES 7-59 
MAXIO 7-53 

NEXTCHAIN 7-47 to 7-49 
OFFSET 7-51 
POST ACT ION 7-46, 7-47 

PREACTIQN 7-46, 7-47 
PREVCHAIN 7-47 to 7-49 
SEQUENCE 7-51 
TYPE 7-58, 7-59 
VERSION 7-50, 7-51 

Advanced MAGNET subcommands: 
LOAD 7-58 
SAVE 7-57, 7-58 

ALIAS ldn option: 

in ASSIGN and UNASSIGN 4-8 
in SEIMOD 5-2 
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ALIAS MTldn, ASSIGN option 4-2, 
4-3 

ALIAS, ASSIGN and UNASSIGN 
option 4-8 

ALL, REPLY option 5-4 

AMOUNT, MAGNET option 
7-39, 7-40 

ANSI format tapes 2-7 

ANSI labels 6-1, 6-2 

ANSI segment control codes 2-6, 

2-13 

ANSI segment control word 2-5, 

2-6, 2-12 

ANSI standard labels 

3-1 to 3-3, 3-5 to 3-7, 3-9 

ANSI standard spanned 
variable-length records 2-5, 
2-6, 2-11 

ANSI standard variable-length 
records 2-2, 2-4 

ASCII 1-10, 1-11 

ASCII to Prime ASCII 
A-25 to A-27 

ASCII: 

character set 2-7 
industry-standard A-l, A-2, 
C-3, C-5 

industry-standard table 
A-7, A-8 

Prime A-l to A-3, A-5, C-2, 

C-5 

Prime table A-9, A-10 

ASSIGN command options: 

7TRK 4-4 
9TRK 4-4 
ALIAS MTldn 4-3 
DENSITY 4-3 
MOUNT 4-4, 4-6 
MTpdn 4-2 


MTX 4-2 
RINGOFF 4-3 
RINGCN 4-3 
TP ID C-6 
TPID id 4-3 
WATT 4-3, 4-4 

ASSIGN: 

command 4-1 to 4-6, 

5-1 to 5-4 

command line format 4-2 
command messages 4-6, 4-7 

Assigning tape drives by: 
logical device number 

4-4 to 4-6 

physical device number 4-4 

AT, MAGNET option 7-28 

Badspots 9-4, 9-9, 

9-15 to 9-17 

BATCH jobs with magnetic tapes 
B-2 

BCD 1-10, C-2 to C-4 

BCD table A-15 

BCD to Prime ASCII translation 
table A-16 

BCDIC 1-10, 1-11, A-2 

BCW 2-2 

Beginning-of-file label group 


Beginning-of-tape marker 1-8 

BFACTOR, MAGNET option 
7-12, 7-13 

BFACTOR, MAGNET option, 
diagrammed 7-14, 7-15 

BINARY C-3 

Binary packing/unpacking 1-11 
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Binary packing/unpacking, 
diagrammed 1-12 

Binary tapes: 

IBM System 360/370 2-7 

Prime 2-7 

Bit settings: 

in PHYSAV and PHYRST messages 
9-7 

Bits 1-2 

Bits per inch 1-2 

Block control word 2-2 

Blocking 1-4 

Blocking factor 1-4, C-2 

BOT 1-8 

bpi 1-2 

Break format 2-6 

Break Key in MAGNET 7-62 

BUFFERS, MAGNET option 7-28 

BYPASS, MAGNET option 7-26 

Bytes 1-10 

Capstan 1-8 

Channels 1-2 

Character codes: 

ASCII 1-10, 1-11 
BCD 1-10 
BCDIC 1-10, 1-11 
defined 1-10 
EBCDIC 1-10, 1-11 
Prime ASCII 1-10 

Character set tables 
A-6 to A-30 

Characters per inch 1-2 


CHARACTERS, MAGNET Option 7-52 

CHARACTERS, MAGNET Option, 
diagrammed 7-54 

Characters: 
fill A-3 

CLOSE: 

MAGNET subcommand 7-61 
Codes: 

packing A-4 

Column position edit token A-2 

Command line format: 

ASSIGN 4-2 
LABEL 6-1 
MAGNET 7-3 
MAGRST 8-5 
MAGSAV 8-1 
PHYRST 9-14 
PHYSAV 9-2 
REPLY 5-4 
SETMOD 5-2 
STATUS DEVICE 4-1 
UNASSIGN 4-8 

Command line options, MAGNET: 
-OPERATOR 7-3, B-l, B-2 
-SILENT 7-3, B-l 
-USER 7-3, B-l, C-5 

Commands: 

ASSIGN 4-1 to 4-6, 

5-1 to 5-4, C-6 
LABEL 6-1 to 6-6, C-6 

REPLY 5-1 to 5-5, B-l 
SETMOD 5-1 to 5-3 
STATUS DEVICE 4-1, 5-1 
UNASSIGN 4-1, 4-8, 5-1 

Comment (/*) MAGNET subcommand 
7-42 

Configurations, diagrammed: 
tape label and file 
3-12 to 3-15 
unlabelled tape file 
3-16 to 3-20 
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Control word: 
block 2-2 
record 2-2 

CONTROL, MAGNET option 7-53 
COPIES, MAGNET option 7-28 
COPY: 

MAGNET subcommand 7-39 
pre-Rev 18.3 C-4 

subcommand line format 7-39 

cpi 1-2 

CREATE, MAGNET option 
7-49, 7-50 


Dialog: 

MAGRST 8-6 to 8-8 
MAGSAV 8-3, 8-4 
FHYRST 9-14, 9-15 

PHYSAV 9-2 to 9-4 

DISK, MAGNET option 7-12 

DISMOUNT messages 7-3, 

B-l, B-2, C-6 

DISPLAY: 

abbreviation C-6 
MAGNET subcommand 7-30, 

subcommand line format 7 

Drive, tape 1-8 


Data definition and manipulation 
subcommands 7-6 

Data transferral subcommands 
7-37 

DECLARE: 

abbreviation C-6 
MAGNET subcommand 7-6 
subcommand line format 7-6 

DEFER, MAGNET option 7-53 


Drive, tape (diagrammed) 1 

DUMEED switch 8-2 

EBCDIC 1-10, 1-11, A-3, 

C-2 to C-4 

EBCDIC table A-ll to A-14 

EBCDIC to Prime ASCII 
translation table 
A-22 to A-24 


DELETE: 

abbreviation C-6 

Edit token A 

A-l 

subcommand 7-34 
subcommand line format 7-34 

Edit token B 

A-2 

Deletion edit token A-3 

Edit token C 

A-2 

DENSITY, ASSIGN option 4-3 

Edit token D 

A-3 

DENSITY, MAGNET option 7-13 

Edit token E 

A-3 

Density, tape 1-2 

Edit token F 

A-3, 

Destination-object-name 7-39 

Edit token list 7 

DEVICE 4-2 

Edit token 0 

A-5 


Edit token P A-5 

Device number: 

logical 4-2 to 4-6, 4-8, 8-6 Edit tokens G through N 
physical 4-2 to 4-4, 4-8, 

5-2, 5-4, 8-6, 9-3, 9-15 
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Edit tokens Q through U A-5 
Edit tokens V through Z A-5 
Edit tokens: 

in MAGNET 7-34 to 7-36 
table of 7-36 
translation of A-l to A-6 

End-of-file label group 3-11 

End-of-tape marker 1-8 

E0F1 3-11 

E0F2 3-11 

EOF3-EDF9 3-11 

EOFn 3-1 

EOT 1-8 

E0V1 3-11 

E0V2 3-11 

EOVn 3-1, 3-2, 3-11 

EXCHANGE, MAGNET option 
7-52, 7-53 

EXCHANGE, MAGNET option, 
diagrammed 7-55 

EXPIRE, MAGNET option 
7-49, 7-50 

External features of a tape 
reel, diagrammed 7-27 

EXTERNAL, MAGNET option 
7-43 to 7-45 

File header label group 3-6, 
3-11 

File header labels (See Header 
labels) 

File marker gaps 1-6 


File markers 1-6 

File, tape 1-6 

FILEID, MAGNET option 7-24 

FILENO, MAGNET option 7-24 

Fill characters A-3 

Fixed-length records: 
defined 1-4, 2-1 
diagrammed 1-5 
standard 2-2 

FORM, MAGNET option 7-29 

FORMAT, MAGNET Option 
7-16, 7-17 

FORMAT, MAGNET option, 
diagrammed 7-18 

Formats, label and tape file 
(See Tape label and file 
configurations) 

Formats, unlabelled tape file 
(See Unlabelled tape file 
configurations) 

Frame, tape 1-2 

Gaps: 

file marker 1-6 
inter-record 1-4, 1-8 

GCR 1-8 

GENERATION, MAGNET option 
7-50, 7-51 

Global variables 7-43 to 7-45 
GO 5-4 

Group code recording 1-8 
HDRl 3-7, 3-8 

HDR2 3-9, 3-10 
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HDRn 3-1, 3-6 

Header labels: 
defined 3-2 
HDRl 3-7, 3-8 

HDR2 3-9, 3-10 

HDRn 3-1, 3-6 

UHLn 3-1, 3-2, 3-5, 3-6 

Heads, read/write 1-8 

Hubs 1-8 

IBM binary tapes 2-7 
IBM format tapes 2-6, 2-7 
IBM labels 6-1 to 6-4 


IBM segment control codes 2-5, 
2-10 


IBM segment control word 2-5, 
2-9 


IBM standard labels 3-1, 3-2, 
3-4 to 3-6, 3-8, 3-10 

IBM standard spanned 
variable-length records 2-5, 
2-8 


IBM standard variable-length 
records 2-2, 2-3 

INC, MAGSAV option 8-2 

Inches per second 1-8 

Industry-standard ASCII 
A-l, A-2, C-3, C-5 

Industry-standard ASCII table 
A-7, A-8 

Industry-standard ASCII to Prime 
ASCII translation table 
A-25 to A-27 

INIT, LABEL option 6-1, 6-2 


Inter-record gaps 1-4, 1-8, 

8-2 

ips 1-8 

IRGs ( See Inter-record gaps) 

ITEMS, MAGNET option 7-29, 7-30 

Jobs, BATCH, with magnetic tapes 
B-2 

Label and tape file formats 
( See Tape label and file 
configurations) 

LABEL command messages: 

PRIMDS errors 6-5, 6-6 

syntax errors 6-3 to 6-5 

LABEL command options: 

ACCESS 6-1, 6-2 

INIT 6-1, 6-2 
OWNER 6-1, 6-2 
TYPE 6-1, 6-2 
VOL 6-2 
VGLID 6-1, 6-2 
VQLSER 6-1, 6-2 

VOLUME 6-1, 6-2 

Label group: 
beginning-of-file 3-6 
defined 3-11 
end-of-file 3-11 
file header 3-6, 3-11 
volume header 3-2, 3-11 

LABEL: 

command 6-1 to 6-6, C-6 
command line format 6-1 

Labelled tapes 3-1 to 3-16 

LABELS, MAGNET option 
7-17, 7-19 

Labels: 

ANSI 6-1, 6-2 

ANSI standard 3-1 to 3-3, 

3-5 to 3-7, 3-9 
header 3-1, 3-2, 3-5 to 3-10 
IBM 6-1 to 6-4 
IBM standard 3-1, 3-2, 
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3- 4 to 3-6, 3-8, 3-10 

Level 1 3-11 

Level 2 3-11 

Level 3 3-11 

trailer 3-1, 3-2, 3-5, 3-11 

types of 3-1 

volume 3-1 to 3-5, 3-11 

LDEVICE 4-2 

ldn ( See Logical device number) 

level 1 labels 3-11 

Level 1 tape 3-11 

Level 2 labels 3-11 

Level 2 tape 3-11 

Level 3 labels 3-11 

Level 3 tape 3-11 

Level 4 tape 3-11 

LEVEL, MAGNET option 7-19 

LEVEL, MAGNET option, diagrammed 
7-20 to 7-23 

LIKE, MAGNET option 7-45 
LINENOS, MAGNET option 7-56 
LINES, MAGNET option 7-59 
LIST: 

abbreviation C-6 
subcommand 7-29 
subcommand line format 7-29 

LOAD: 

abbreviation C-6 
MAGNET subcommand 7-58 
subcommand line format 7-58 

Logical device number: 
assigning tape drives by 

4- 4 to 4-6 

defined 4-3 

in MAGRST dialog 8-6 
in MAGSAV dialog 8-3 


unassigning tape drives by 
4-8 ' 

Logical record 1-4, 2-5, 2-6 

Logical record size C-2 

Logical tape format 1-6 

Logical tape format, diagrammed 
1-7 

LONG, MAGSAV option 8-2 

LRECL, MAGNET option 7-12, 7-13 

LRECL, MAGNET option, diagrammed 
7-14, 7-15 

MAGNET subcommand options: 

ACCESS 7-49 
AMOUNT 7-39, 7-40 
AT 7-28 

BFACTOR 7-12, 7-13 
BFACTOR, diagrammed 
7-14, 7-15 
BUFFERS 7-28 
BYPASS 7-26 
CHARACTERS 7-52 
CONTROL 7-53 
COPIES 7-28 
CREATE 7-49, 7-50 
DEFER 7-53 
DENSITY 7-13 
DISK 7-12 
EXCHANGE 7-52, 7-53 
EXPIRE 7-49, 7-50 
EXTERNAL 7-43 to 7-45 
FILEID 7-24 
FILENO 7-24 
FORM 7-29 
FORMAT 7-16, 7-17 
FORMAT, diagrammed 7-18 
GENERATION 7-50, 7-51 
ITEMS 7-29, 7-30 
LABELS 7-17, 7-19 

LEVEL 7-19 
LEVEL, diagrammed 
7-20 to 7-23 
LIKE 7-45 
LINENOS 7-56 
LINES 7-59 
LRECL 7-12, 7-13 
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LRECL, diagrammed 7-14, 7-15 

MAXIO 7-53 

MODE 7-41 r 7-42 

NEXTCHAIN 7-47 to 7-49 

OFFSET 7-51 

OWNER 7-24, 7-25 

PAD 7-56 

PARITY 7-17 

POST ACTION 7-46, 7-47 

PREACTION 7-46, 7-47 

PREVCHAIN 7-47 to 7-49 

PRINT 7-40, 7-41 

PROTECT 7-17 

RECORDNO 7-25, 7-26 

SEQUENCE 7-51 

SPOOL 7-12 

table of 7-7 to 7-11 

TAPE 7-12 

TRACKS 7-13 

TYPE 7-58, 7-59 

VERSION 7-50, 7-51 

VISUAL 7-26 

VGLSER 7-25 

MAGNET: 

additional features and notes 
C—1 to C-6 

advanced 7-42 to 7-62 
basic steps 7-2 
facilities provided by 
7-1, 7-2 
invoking 7-3 
messages 7-64 to 7-97 
Pre-Rev 18.3 features 
C-l to C-6 

sample session 7-62 to 7-64 
subcommand line format 7-3 
subcommands 7-3 
types of messages 7-64 
using 7-2 

Magnetic spots 1-2 

Magnetic tape standards 
2-6 to 2-13 

Magnetic tapes: 
physical characteristics of 
1 - 1 , 1-2 

MAGRST command options: 

7TRK 8-5, 8-6 
TTY 8-6 


MAGRST: 

command line format 8-5 
dialog 8-6 to 8-8 
messages 8-9 to 8-14 
sample session 8-8, 8-9 
subsystem 8-1, 8-5 to 8-14 

MAGSAV command options: 

7TRK 8-2 
INC 8-2 
LONG 8-2 
SAVEJUFD 8-2A 
TTY 8-2 
UPDT 8-2 
VAR 8-2 

MAGSAV: 

command line format 8-1 
dialog 8-3, 8-4 
messages 8-9 to 8-14 
sample session 8-4, 8-5 
subsystan 8-1 to 8-5, 

8-9 to 8-14 

Marker: 

beginning-of-tape 1-8 
end-of-tape 1-8 
file 1-6 
tape 1-6 

MAXIO, MAGNET option 7-53 
Messages: 


ASSIGN 

4-6, 4-7 

DISMOUNT 7-3, B-l, ! 

LABEL 

6-3 to 6-6 

MAGNET 

* 7-64 to 7-97 

MAGRST 

8-9 to 8-14 

MAGSAV 

8-9 to 8-14 

MOUNT 

7-3, B-l, B-2 

PHYRST 

9-17 to 9-20 

PHYSAV 

9-5 to 9-13 

REPLY 

5-5 

SETMOD 

5-2, 5-3 

UNASSIGN 4-9 


MODE, MAGNET option 7-41, 7-42 
MODIFY: 

abbreviation C-6 
MAGNET subcommand 
7-32 to 7-34 

subcommand line format 7-32 
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MOUNT messages 7-3, B-l, B-2, 
C-6 

MOUNT REPLY mechanism C-5 
MOUNT, ASSIGN option 4-4, 4-6 
Mounting tapes 4-6 
MOVE: 

abbreviation of C-6 
MAGNET subcommand 7-38, 7-39 
subcommand line format 7-38 

MTpdn 4-2 

MTX 4-2 

Multiple files, multiple reels 
3-15, 3-20 

Multiple files, single reel 
3-14, 3-18 

Multiple reels, multiple files 
3-15, 3-20 

Multiple reels, single file 
3-13, 3-19 

NEXTCHAIN, MAGNET option 
7-47 to 7-49 

Nine-track tape: 
defined 1-2 
diagrammed 1-3 
parity of 1-10 

No assignment mode 5-1, 5-2 

NOASSIGN, SETMOD option 5-2 

NOISY, MAGNET subcommand 7-61 

Non-return to zero inverted 1-8 

NRZI 1-8 

Object-name 7-6, 7-29, 7-39, 
7-41 


Off-line 4-8 

OFFSET, MAGNET option 7-51 

Open status 7-29, 7-30 

Operator mode 5-1, 5-2 

OPERATOR, MAGNET option 
7-3, B-l, B-2 

OPERATOR, SETMOD option 5-2 

OPR ( See OPERATOR, MAGNET 
option) 

OWNER, LABEL option 6-1, 6-2 

OWNER, MAGNET option 7-24, 7-25 

Packing codes A-4 

Packing/unpacking, binary 1-11 

Packing/unpacking, binary 
(diagrammed) 1-12 

PAD, MAGNET option 7-56 

Parity bit 1-10 

Parity track 1-10 

PARITY, MAGNET option 7-17 

Partition 9-1, 9-2, 9-4 

pdn 4-2 

PE 1-8 

Phase-encoded 1-8 
PHYRST: 

bit settings in messages 9-7 
command line format 9-14 
command option 9-14 
dialog 9-14, 9-15 
messages 9-17 to 9-20 
reentering 9-16 
sample session 9-16, 9-17 
subsystem 9-1, 9-14 to 9-20 
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PHYSAV: 

bit settings in messages 9-7 
command line format 9-2 
command option 9-2 
dialog 9-2 to 9-4 
messages 9-5 to 9-13 
reentering 9-4 
sample session 9-5 
subsystem 9-1 to 9-13 

Physical block 2-6 

Physical device number: 

assigning tape drives by 4-4, 
5-2, 5-4 
defined 4-2 
in MAGRST dialog 8-6 

in MAGSAV dialog 8-3 

in PHYRST dialog 9-15 

in PHYSAV dialog 9-3 

unassigning tape drives by 
4-8 

Physical record 1-4, 2-6 

POSITION: 

abbreviations C-6 
MAGNET subcommand 7-41, 7-42 
pre-Rev 18.3 C-l, C-2 
subcommand line format 7-41 

Positioning, absolute 7-41, 

C-l, C-2 

Positioning, relative 7-41, 

C-l, C-2 

POSTACTION, MAGNET option 
7-46, 7-47 

Postamble 1-4, 1-8 

POSTION subcommand: 
modes C-l, C-2 

Pre-Rev 18.3 MAGNET C-l to C-6 

PREACTION, MAGNET option 
7-46, 7-47 

Preamble 1-4, 1-8 


PREVCHAIN, MAGNET option 
7-47 to 7-49 

Prime ASCII 1-10, A-l to A-3, 
A-5, C-2, C-5 

Prime ASCII table A-9, A-10 

Prime ASCII to BCD translation 
table A-17, A-18 

Prime ASCII to EBCDIC 
translation table 
A-l9 to A-21 

Prime ASCII to industry-standard 
ASCII translation table 
A-28 to A-30 

Prime binary tapes 2-7 

Prime variable-length format 
2-6 

PRINT, MAGNET option 7-40, 7-41 

PROTECT, MAGNET option 7-17 

QUIT: 

MAGNET subcommand 7-42 
pre-Rev 18.3 C-4 

subcommand line format 7-42 

RAT (See Record availability 
table) 

RCW 2-2 

Read/write heads 1-8 

READ: 

abbreviation C-6 
MAGNET subcommand 7-37 
pre-Rev 18.3 C-2, C-3 

subcommand line format 7-37 

Record availability table (RAT) 
9-2, 9-3, 9-6 to 9-8, 9-11 

Record control word 2-2 
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# 

c 


REOORDNO, MAGNET option 
7-25, 7-26 

Records: 

fixed-length 1-4, 2-1, 2-2 
fixed-length, diagrammed 1-5 
logical 1-4, 2-5, 2-6 
MAGNET uncompressed 7-16 
physical 1-4 

spanned variable-length 2-5, 

2-6, 2-8 

variable-length 2-1 to 2-6, 

2-8 

Reel, tape (diagram of external 
features) 7-27 

Reel: 

physical characteristics of 
1-2 

supply 1-8 
take-up 1-8 

Relative positioning 7-41, 

C-l, C-2 

REN 9-16 

RENAME: 

abbreviation C-6 
MAGNET subcommand 7-32 
subcommand line format 7-32 

REPEAT, REPLY Option 5-4 

Repetition factor * A-5 

REPLY command options: 

ABORT 5-4 
ALL 5-4 
GO 5-4 
REPEAT 5-4 
RESEND 5-4 
TAPE 5-4 

REPLY: 

command 5-1 to 5-5, B-l 
command line format 5-4 
command message 5-5 

RESEND, REPLY Option 5-4 


RINGOFF 4-3 
RINGCN 4-3 
SAVE: 

MAGNET subcommand 7-57, 7-58 
subcommand line format 7-57 

SAVE_UFD, MAGSAV option 8-2A 

SCC ( See Segment control codes) 

SCW ( See Segment control word) 


Segment 

2-5, 2-6 

Segment 

control codes: 

ANSI 

2-6, 2-13 

IBM 

2-5, 2-10 

Segment 

control word: 

ANSI 

2-5, 2-6, 2-12 

IBM 

2-5, 2-9 

Segment 

descriptor 2-5, 2-6 


SEQUENCE, MAGNET option 7-51 


SETMOD command modes: 
no assignment 5-1, 5-2 
operator 5-1, 5-2 
user (default) 5-1, 5-2 

SETMOD command options: 
NOASSIGN 5-2 
OPERATOR 5-2 
USER 5-2, 5-3 

SETMOD: 

command 5-1 to 5-3 
command line format 5-2 
command message 5-3 
console messages 5-2, 5-3 

Settings, tape density 4-3 

Seven-track tape: 
defined 1-2 

diagrammed 1-3 
parity of 1-10 
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Severity 0 MAGNET message 

7-64 

Severity 1 MAGNET message 

7-64 

Severity 2 MAGNET message 

7-64 

Severity 3 MAGNET message 

7-64 

SILENT, MAGNET option 7- 

-3, B-l 


SILENT: 

MAGNET subcommand 7-61 


Single file, multiple reels 
3-13, 3-19 

Single reel, multiple files 
3-14, 3-18 

Single reel, single file 3-12, 
3-17 

Source-object-name 7-39 

Spanned records: 
variable-length 2-5, 2-8 

Speed, tape drive 1-8 

SPOOL, MAGNET option 7-12 

Standards: 

magnetic tape 2-6 to 2-13 

STATUS DEVICE: 

command 4-1, 5-1 
command line format 4-1 

Subcommand line format: 

/* 7-42 

OOPY 7-39 
DECLARE 7-6 
DELETE 7-34 
DISPLAY 7-30 
LIST 7-29 
LOAD 7-58 
MAGNET 7-3 
MODIFY 7-32 
MOVE 7-38 
POSITION 7-41 
QUIT 7-42 
READ 7-37 
RENAME 7-32 


SAVE 7-57 
TRANSLATE 7-34 
WRITE 7-37 

Subcommand options: 

MAGNET 7-12 to 7-59 
table of MAGNET 7-7 to 7-11 

Subcommands, advanced MAGNET: 
LOAD 7-58 
SAVE 7-57, 7-58 

Subcommands: 

/* (comment) 7-42 
abbreviations for C-6 

additional MAGNET 7-41 

CLOSE 7-61 
COPY 7-39, C-l, 0-4 
data definition and 
manipulation 7-6 
data transferral 7-37 
DECLARE 7-6, C-6 
DELETE 7-34, C-6 
DISPLAY 7-30, 7-31, C-6 
LIST 7-29, C-6 
LOAD C-6 
MAGNET 7-3 

MODIFY 7-32 to 7-34, C-6 
MOVE 7-38, 7-39, C-6 
NOISY 7-61 
POSITION 7-41, 7-42, 

C-l, C-2, C-6 
QUIT 7-42, C-6 

READ 7-37, C-l to C-3, C-6 

RENAME 7-32, C-6 
SILENT 7-61 

table of MAGNET 7-4, 7-5 
TRANSLATE 7-34, 7-35, A-l 
WRITE 7-37, 7-38, 

C-l, C-3, C-4 

Subsystems: 

MAGNET 7-1 

MAGRST 8-1, 8-5 to 8-14 

MAGSAV 8-1 to 8-5, 

8-9 to 8-14 

PHYRST 9-1, 9-14 to 9-20 
PHYSAV 9-1 to 9-13 

SUED, MAGSAV option 8-2A 
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Supply reel 1-8 

Swapping bytes in MAGNET 
7-52, 7-53 

Tables: 

BCD A-15 

character set A-6 to A-30 
EBCDIC A-ll to A-14 
industry-standard ASCII 
A-7, A-8 

Prime ASCII A-9, A-10 

translation A-16 to A-30 


Take-up reel 1-8 


TAPE 5-4 


Tape character 1-2 


Tape density settings 

4-3 

Tape drive, described 

1-8, 1-9 

Tape drive, diagrammed 

1-9 

Tape drives, assigning by: 


logical device number 
4-4 to 4-6 

physical device number 4-4 

Tape drives, unassigning by: 
logical device number 4-8 
physical device number 4-8 

Tape file 1-6 

Tape format, logical 1-6 

Tape format, logical 
(diagrammed) 1-7 

Tape frame 1-2 

Tape label and file 

configurations, diagrams 
3-12 to 3-15 

Tape marker 1-6, 2-7 

Tape reel: 

external features, diagrammed 
7-27 


TAPE, MAGNET option 7-12 
Tape: 

positioning 7-41 
Tapes: 

density of 1-2 

labelled 3-1 to 3-16 

Level 1 3-11 

Level 2 3-11 

Level 3 3-11 

Level 4 3-11 

nine-track 1-2, 1-10 

nine-track, diagrammed 1-3 

seven-track 1-2, 1-10 

seven-track, diagrammed 1-3 

unlabelled 3-16 to 3-20 

Tokens, edit A-l to A-6 

TPID, ASSIGN option 4-3, 4-6, 
C-6 

Tracks 1-2 

TRACKS, MAGNET option 7-13 

Trailer labels: 
defined 3-2 ' 

EOFl 3-11 
EOF2 3-11 
EOF3-EDF9 3-11 
EOFn 3-1 

UTLn 3-1, 3-2, 3-5, 3-11 
TRANSLATE: 

MAGNET subcommand 7-34, 7-35 
subcommand line format 7-34 
used with edit tokens 
A-l to A-6 

Translation edit tokens, table 
of 7-36 

Translation tables: 

BCD to Prime ASCII A-16 
creating 7-59 to 7-61 
EBCDIC to Prime ASCII 
A-22 to A-24 

Prime ASCII to BCD A-17, A-18 
Prime ASCII to EBCDIC 
A-19 to A-21 
Prime ASCII to 
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industry-standard ASCII 
A-28 to A-30 

TTY option: 

in MAGRST 8-6 
in MAGSAV 8-2 

TYPE, LABEL Option 6-1 

TYPE, MAGNET option 7-58, 7-59 

UHLn 3-1, 3-2, 3-5, 3-6 

UNASSIGN command options: 

ALIAS 4-8 
ALIAS ldn 4-8 
UNLOAD 4-8 

UNASSIGN: 

command 4-1, 4-8, 5-1 
command line format 4-8 
command messages 4-9 

Unassigning tape drives by: 
logical device number 4-8 
physical device number 4-8 

Uncompressed records 7-16 

Unlabelled tape file formats 
( See Unlabelled tape file 
configurations) 

Unlabelled tapes 3-16 to 3-20 

UNLOAD, UNASSIGN option 4-8 

UNMDD option: 
in PHYRST 9-14 

in PHYSAV 9-2 

UPDT, MAGSAV option 8-2 

User (default) mode, in ASSIGN 
5-1 to 5-3 

USER option: 

in MAGNET 7-3, B-l, C-5 
in SETMOD 5-2 

USRNAM 4-2 


USRNUM 4-2 

UTLn 3-1, 3-2, 3-5, 3-11 

UVLn 3-1, 3-2 

Vacuum chamber 1-8 

VAR, MAGSAV option 8-2 

Variable-length records: 

ANSI standard 2-2, 2-4 
ANSI standard spanned 2-5, 
2-6, 2-11 
defined 2-1 
IBM standard 2-2, 2-3 
IBM standard spanned 2-5, 2-8 
Prime 2-6 

Variables, global 7-43 to 7-45 

VERSION, MAGNET Option 
7-50, 7-51 

VISUAL, MAGNET option 7-26 

VOL, LABEL option 6-2 

VQLl 3-3, 3-4 

VQL2-VQL9 3-5 

VOLID, LABEL option 6-1, 6-2 

VQLn 3-1, 3-2 

VCLSER, LABEL option 6-1, 6-2 

Volume header label group 3-2, 
3-11 

Volume labels EOVn 3-2 

Volume labels: 
defined 3-1 
EOVL 3-11 

EOV2 3-11 

EOVn 3-1, 3-2, 3-11 

UVLn 3-1, 3-2, 3-5 

VCLl 3-3, 3-4 

VGL2-VGL9 3-5 
VQLn 3-1, 3-2 
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VOLUME, LABEL option 6-1, 6-2 

WAIT, ASSIGN option 4-3, 4-4 

Write-enable ring, use of with 
ASSIGN 1-2, 4-3 

Write-enable ring, with PHYSAV 
9-12 

WRITE: 

MAGNET subcommand 7-37, 7-38 
pre-Rev 18.3 C-l, C-3, C-4 
subcommand line format 7-37 
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